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ABSTRACT 


MADAM  (Moderately  Advanced  DAta  Management)  is  a 
program  which  builds  and  manipulates  files,  and 
generates  reports.  This  document  describes  Version 
IV  of  the  system— its  rationale,  utilization,  grammar 
and  vocabulary.  I  of  the  MADAM  System, 

described  in  IM- 2196/000 / 00 ,  is  superseded.  All 
specifications  prepared  by  reference  to  TM“2198/00l/00 
Version  II  manual,  viU.  operate  properly  in  the 
Version  IV  system. 
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I.  INTRODUCTION 


MADAM  (Moderately  Advanced  DAta  Management)  in  a  file  builder,  a  file 
manipulator,  and  report  generator.  It  provides  a  mennn  for  taking  initially 
unorganized  lines  of  data  (records)  and  organizing  them  in  a  donor ibnble  and 
retrievable  manner  into  data  seta  (files).  It  maintains  these  files,  creates 
new  ones,  and  prints  the  contents  of  these  files  in  various  formats.  The 
system  processes  alphabetic  and  numeric  data  as  well  as  English  language 
text  on  the  IBM  1401  computer.  It  was  originally  developed  for  use  on  metro¬ 
politan  data  problems;  however,  its  data  manipulation  capability  is  quite 
general.  First,  the  program  translates  the  user's  language  to  machine 
understandable  language  and  communicates  it  to  the  machine.  Tills  process 
occurs  once  for  each  set  of  specification  statements.  Second,  the  machine  in¬ 
terprets  the  translated  path  and  performs  the  required  operations  once  for 
each  file  record  to  be  processed. 

The  MADAM  System  operates  on  a  particular  user's  problem  by  means  of  a  net  of 
specification  statements  in  a  language  very  much  like  that  of  the  user. 

MADAM  itself  la  made  up  of  computer  programs  which  translate  and  interpret 
the  specification  statements  and  perform  the  required  operations.  The  speci¬ 
fications  are  incorporated  in  a  control  card  deck  that  is  operated  upon  by 
the  system  in  conjunction  with  data  cards  or  magnetic  tape  files. 

MADAM  Is  Implemented  on  an  IBM  1U01  computer  with  8,000  characters  core 
storage  and  four  to  five  tape  units.  Its  capabilities,  representing  only  a 
state  of  moderate  advancement  in  file  processing  and  report  generation,  were 
selected  because:  they  represent  an  area  of  high  work  volume  and  general 
need;  they  could  be  implemented  within  n  reasonable  time  span;  nnd  they  wer  ■ 
possible  within  the  space  limitations  of  a  small  computer. 

This  guide  to  the  use  of  the  MADAM  System  describes  in  detail  each  MADAM 
operation  in  Chapters  n  and  III.  A  brief  summary  of  how  the  system  may  be 
used  as  vail  as  examples  are  provided  in  Chapter  IV. 


2  December  1965 


6 


TM-2198/002/00 


\ 


II.  MADAM  SYSTEM  LANGUAGE  CONVENTIONS 

The  following  paragrnpns  describe  the  operation  and  control  of  the  MADAM 
System  in  te-ms  of  x'..l  English  wordG  that  may  be  used  to  direct  the  system's 
operation,  tl  5  data  processing  functions  performed  by  the  aye  tern,  and  the 
kinds  of  data  entities  or  objects  upon  which  the  oystpm  operates.  Some 
definitions  are  in  order  If  ambiguity  and  confusion  are  to  be  avoided.  A 
word,  as  defined  in  the  MADAM  language,  is  a  string  of  alphanumeric  characters 
separated  from  a  preceding  and  following  string  by  a  blank  or  comma.  A 
MADAM  TERM  is  a  word  that  has  particular  meaning  for  the  MADAM  System. 

Any  word  composed  of  numeric  characters  only  is  a  MADAM  TERM.  Any  word 
having  a  left  parenthesis  as  its  leading  character  and  a  right  parenthesis 
as  its  trailing  character  is  a  MADAM  TERM.  Any  word  in  the  following  list 
is  a  MADAM  TERM- 


a 

END 

MORE 

4- 

ENDA 

NEXT 

$ 

ENDS 

NQ 

* 

EQ 

NUMBER 

- 

FIELD 

NUMERIC 

/ 

FORMAT 

OPERATE 

ABSTRACT 

OR 

ADJUST 

GR 

OUT 

ALIGN 

IDENT 

PAGE 

AND 

IF 

PAUSE 

ANY 

IN 

POSITION 

BLOCK 

INA 

PREFIX 

BY 

I  MB 

PRINT 

CALL 

ITEM 

READ 

CARDS 

KEY 

READA 

CATALOG 

LIBRARY 

»  * 

READB 

COLUMN 

LINE 

REMAINDER 

COMBINE 

LOAD 

RETORT 

COMPUTE 

LQ 

RESTORE 

COPY 

LS 

RESULT 

DO 

MARK 

SCAN 
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SET 

SUBSET 

WRITL 

SIZE 

SUFFIX 

WRITE 

SKIP 

TEMP 

#* 

SORT 

TERM 

**#* 

STOP 

WORD 

Words  occurring  in  MADAM  System  specifications,  other  than  those  enumerated 
above,  are  Ignored  by  the  system.  The  words  above  are  also  ignored  except 
in  the  particular  operation  in  which  they  exercise  control. 

MADAM  specification  cards  are  processed  by  the  MADAM  translator  as  a  continuous 
stream  of  text  starting  with  an  operation  declaration  and  ending  with  the 
MADAM  term  END.  Between  the  END  term  of  a  previous  specification  and  the 
operation  declaration  of  the  following  specification,  system  control  is 
returned  from  the  operation  level  of  translation  to  the  system  executive 
routine.  To  reduce  control  information  transfer,  the  system  executive  expects 
to  find  the  next  operation  declaration  beginning  on  a  card.  For  this  reason, 
data  following  the  terminal  END  on  a  MADAM  specification  card  is  not  processed. 

Within  the  continuous  stream  of  text  of  a  specification,  words  and  parameters 
must  be  separated  by  at  least  one  b^.ank  or  comma.  A  period  may  not  terminate 
a  word  unless  that  word  is  a  label  as  defined  in  Chapter  III  Language 
Structure  Terms.  Any  string  of  characters,  including  blanks,  commas,  periods, 
and  left  and  right  parenthesis  may  be  declared  to  be  a  literal  or  constant 
term  by  preceding  the  literal  string  with  the  character  pair- -blank,  left 
parenthesis --and  by  terminating  the  literal  string  by  the  character  pair-- 
right  parenthesis,  blank.  A  right  parenthesis  within  a  literal  must  not  be 
directly  followed  by  a  blank  or  comma. 

Data  as  understood  by  the  MADAM  System,  include  all  keypunch  characters  legal 
for  the  IBM  1401  excepting  the  characters  TAPE  MARK  (7-8),  GROUP  MARK  (12-7-6), 
and  RECORD  MARK  (0-2-8).  These  three  characters,  because  of  their  special 
meaning  in  the  IBM  lUOl  for  magnetic  tape  handling,  may  not  normally  be 
included  in  data  files  but  may  be  specified  as  constants  or  literals  in  the 
language.  A  TAPE  MARK,  however,  may  not  appear  among  specifications  catalogued 
on  a  MADAM  library. 
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A.  File  Designations 

FILES  are  designated,  by  an  ordered  pair  of  numbers.  The  first  number 
refers  to  the  sequential  position  of  the  file  on  a  reel  of  magnetic  tape. 
The  second  designates  the  tape  handler  or  unit  on  which  a  reel  containing 
the  file  is  mounted.  One  or  more  words  may  precede  each  number  to  assist 
readability  by  users.  They  are  treated  by  MADAM  as  "noise"  words  and  do 
not  affect  system  operation.  File  designations  may  take  the  following 
forms  in  the  case  of  file  2  on  unit  3: 


2,3 

FIIE  2  TAPE  3 

FILE  NUMBER  2  ON  TAPE  HANDLER  3 
Two  special  file  designations  are  also  permitted: 

(1)  FILE  0  TAPE  0,  or  the  word  CARDS,  is  interpreted  to  mean 
that  the  file  is  in  IBM  punch  card  form. 

(2)  THE  NEXT  FIUS  ON  UNIT  3,  or  NEXT  3,  is  interpreted  to  mean 
that  no  tape  positioning  is  required  to  obtain  the  specified 
file. 

Tape  units  vhich  may  be  referred  to  in  MADAM  specifications  are 
0,2, 3/4,  5  and  6.  Unit  1  is  reserved  for  the  MADAM  System  tape. 

In  MADAM  System  specifications  output  files  are  always  declared  prior 
to  declaring  input  files.  Thus  the  statement:' 

SUBSET  1,3  FROM  1,2 

declares  file  1  unit  3  as  an  output  file  and  file  1  unit  2  as  an 
input  file. 

When  FORMAT,  SUBSET,  or  ABSTRACT  specifications  call  for  two  output 
files,  the  term  AND  is  used  to  link  the  second  output  file  declaration 
to  the  first  and  thuB  to  differentiate  it  from  input  file  designations 
that  follow. 

SUBSET  1,3  AND  l,l»  FROM  1,2 

declares  file  1  unit  3  and  file  1  unit  4  as  output  files. 


I 
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III.  SYSTEM  OPERATIONS 

TERMS  initiate  major  operations  in  the  system: 

Designates  the  operation  of  constructing  a  file  on 
magnetic  tape  from  punched  card  input.  The  input 
cards  may  be  introduced  via  the  card  reader  (direct) 
or  via  a  previously  prepared  magnetic  tape  (prestored). 

Designates  an  operation  that  permits  records  of  a 
magnetic  tape  file  to  be  grouped  into  collections  * 
of  records.  Each  such  collection  becomes  a  single 
physical  record  in  the  output  file. 

Designates  an  operation  in  which  records  of  a  magnetic 
tape  file  may  be  selected  for  inclusion  in  one  or  two 
output  files  on  the  basis  of  complex  selection  criteria. 

Designates  an  operation  in  which  records  from  two 
magnetic  tape  files  may  be  selected  for  combination 
into  one  or  two  output  files  based  on  complex  selection 
criteria. 

Designates  an  operation  which  orders  the  records  of  a 
magnetic  tape  file  in  alphabetic  or  numeric  order  by 
selected  keys. 

Designates  an  operation  in  which  the  contents  cf  a 
magnetic  tape  file  may  be  displayed  in  the  form  of  a 
printed  report . 

Designates  an  operation  in  which  the  contents  of  a 
magnetic  tape  file  may  be  transformed  and  written  as 
one  or  two  new  tape  files  and,  simultaneously,  included 
in  a  printed  report. 

Designates  the  operation  of  magnetic  tape  file  repro¬ 
duction.  Binary  tapes  are  not  handled  by  the  MADAM 
System. 

Designates  an  operation  in  which  files  from  an  input 
magnetic  tape  may  be  specified  for  inclusion  in  a 
single  output  tape  file. 
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Designates  an  operation  in  which  the  specified  file  is 
assumed  to  contain  a  l^Ol  program  in  AUTOCODER  output 
unit  record  format:  the  program  is  loaded  into  core 
memory  and  control  is  transferred  to  the  leaded  program 

Designates  an  operation  in  which  a  named  card-set 
(including  but  not  limited  to  MADAM  specifications)  is 
loaded  (catalogued)  onto  a  library  tape. 

Designates  an  operation  in  which  a  named  card-set  ia 
retrieved  from  a  library  tape.  If  the  CALL  operation 
occurs  within  a  card-set  which  is  being  catalogued  on 
the  library,  the  named  card-set  replaces  the  card 
containing  the  CALL  term.  Otherwise  the  named  card--s  :t 
is  assumed  to  contain  MADAM  specifications  and  is 
translated  and  executed. 

Designates  an  operation  in  which  up  to  three  magnetic 
tape  units  may  be  positioned  to  the  starting  record 
of  specified  files.  This  operation  can  be  used  for 
rewinding  tape  at  the  end  of  a  complete  Job. 

Introduces  a  message  card.  The  contents  of  the  card 
will  be  logged  on  the  printer  followed  by  a  system 

pause. 

Brackets  a  string  of  alphanumeric  characters  intended 
as  a  comment.  The  bracketed  string  is  not  translated 


fleeted  by  System  Operations 

cs  may  be  performed  upon  logical  entities  and  physical 


A  field  is  a  succession  or  "string"  of  contiguous 
alphabetic  or  numeric  (alphanumeric)  characters. 

A  field  in  the  MADAM  System  may  be  up  to  132  characters 
in  length. 

A  record  ia  a  collection  of  fields  containing  infor¬ 
mation  relevant  to  an  individual  entity  or  thing.  The 
standard  maximum  record  sice  in  MADAM  is  1000 
characters. 
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FILE  A  file  is  a  collection  of  records  having  a  common 

.  logical  structure  and  containing  information  relevant 
to  a  particular  set  of  individual  entities  or  things, 

In  the  MADAM  System,  a  file  may  not  exceed  the  storage 
capacity  of  one  magnetic  tape  reel. 

TAPE  A  tape  (reel  of  magnetic  tape)  may  contain  one  or  many 

files  separated  by  end-cf-file  marks,  each  file  composed 
of  physical  tape  records  separated  by  end-of-record  gaps. 
Only  BCD  data  is  processed  by  the  MADAM  system. 

CARD  A  deck  of  IBM  cards  may  contain  a  file.  Each  record 

in  such  a  file  may  occupy  one  or  many  physical  cards. 
Multicard  records  are  identified  by  a  card-set 
identity  field  in  each  such  card.  Card  files  are 
terminated  by  a  card  containing  a  GROUP  MARK  character 
(12-7-8  punch)  in  card  column  1. 

REPORT  A  report  represents  the  contents  of  a  file  displayed 

in  printed  form.  Reports  are  made  up  of  LINES  and 
PAGES.  A  record  may  be  represented  in  one  or  many 
lines  or  pages.  Reports  may  be  headed  or  formatted  in 
any  manner. 


A.  Non-Procedural  System  Operations 

Operations  In  the  MADAM  System  are  specified  with  information  files  as 
their  object. 


The  operations  COPY,  COMBINE  and  SORT  require  only  little  detail  of  the 
user  as  their  processes  are  fairly  standard  to  information  handling. 


The  processes  WAD  and  BLOCK  recognize  fields  within  the  unit  records  of 
the  files  they  operate  upon.  Thus,  data  about  where  these  fields  are  to 
bo  found  in  the  input  file  and  where  they  are  to  be  positioned  in  the 
output  file  ate  required. 


The  processes  PRINT,  FOFMAT,  SUBSET,  and  ABSTRACT,  in  order  to  be  useful 
across  a  broad  spectrum  of  data  handling  problems,  penr.it  the  user  to 
express  much  greater  detailed  information  about  the  files  being  handled 
or  created.  The  majority  of  the  power  for  logical  manipulation  of 
infonnation  is  in  these  processes.  Most  of  the  MADAM  language  terms  are 
needed  here. 


In  the  following  paragraphs  the  use  of  each  of  the  major  MADAM  processes 
will  be  described.  The  effect  of  MADAM  TERMS  applicable  in  each  process 
will  be  shown  in  detail. 
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1 .  The  LOAD  Operation 

The  LOAD  operation  provides  several  standard  methods  of  file  building 
from  80-character  unit  records.  The  first  method  functions  as  a  normal 
pre-store  operation.  Each  incoming  card  or  record  occupies  one  record 
in  the  resulting  file.  A  second  method  permits  the  user  to  specify 
card-set  identification  fields  in  the  input  unit  records.  In  this 
option,  all  sequential  cards  having  the  spme  set  identity  will  occupy 
the  same  record  on  tape.  Card  numbers  are  generated  by  the  system 
according  to  their  sequential  occurrence.  The  third  method  is  a 
refinement  on  the  second.  In  addition  to  a  card-set  identification 
field  for  each  card,  a  card  number  vithin  a  set  may  be  specified. 

Thus  cards  need  not  be  ordered  sequentially  within  a  set  in  this 
method.  Each  card  will  be  uniquely  identified  by  its  identity  field 
and  number  field.  In  any  of  the  three  methods,  fields  may  be  declared 
within  any  card  and  each  declared  field  may  be  loaded  at  a  specified 
position  in  the  resulting  record.  A  LOAD  operation  is  initiated  by 
a  declaration  in  the  form: 

LOAD  (output  file  designation)  (input  file  designation) 

The  following  examples  represent  forms  of  the  LOAD  declaration  that 
are  all  acceptable  to  the  system: 

LOAD  FILE  1  TAPE  2  FROM  FILE  3  TAPE  3 

LOAD  FILE  1  TAPE  2  FROM  CARDS 

LOAD  1,2  FROM  3,3 

LOAD  1,2,  3,  3 

Only  four  English  words,  IDENT,  FIELDS,  NUMBER,  and  END,  are  under¬ 
stood  by  the  LOAD  operation.  All  others  are  considered  to  be  "noise" 
words. 

IDENT  causes  the  program  to  expect  two  following  numeric  identifiers. 

The  first  such  number  is  assumed  to  be  the  beginning  card  column  of 
the  field  that  contains  a  card-set  identification.  The  field  may  be 
located  anywhere  in  the  card  and  may  be  of  any  si2e  up  to  80  characters. 
The  second  number  is  interpreted  to  represent  the  number  of  card 
columns  in  the  card-set  identity  field.  The  use  of  the  word  IDENT  is 
optional. 
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The  card-set  identity  is  used  to  group  data  from  more  than  one  card 
into  the  seme  record  on  the  output  tape.  Cards  having  the  same 
identity  are  considered  to  belong  to  the  same  record.  For  example, 
cards  concerning  an  employee  could  be  grouped  according  to  his  unique 
employee  number. 

NUMBER  causes  the  program  to  expect  two  numbers  specifying  the 
beginning  card  column  and  number  of  columns  containing  a  card 
identity  number.  The  card  identity  number  is  used  tc  associate  the 
input  card  with  the  correct  FIELD  description  as  explained  below. 

When  card-set  identities  have  been  specified  through  use  of  the  term 
IBEIfT,  the  use  of  the  term  NUMBER  is  optional.  When  IDENT  is  not  used 
in  the  specification,  the  term  NUMBER  will  be  ignored. 

FIEIDS  causes  the  program  to  expect. sets  of  four  numeric  indicators  to 
fellow,  describing  fields  to  be  loaded:  , 

a.  The  first  number  is  the  identity  or  sequence  number  of  the  card 
within  a  card-set.  When  no  card  identity  number  is  supplied, 
cards  within  sets  are  automatically  numbered  sequentially  from 
"1.”  Where  no  card-set  identity  is  specified,  card-sets  are 
assumed  to  exist  consisting  of  one  card  per  set.  The  sequence 
number  1  must  still  be  provided,  even  x'or  a  ono-card  set. 

t.  The  second  number  is  the  lowest  numbered  card  column  occupied  by 
the  field  being  described  (l-80). 

c.  The  third  is  the  number  of  card  columns  occupied  by  the  field 

(1-80). 

d.  The  fourth  and  last  number  is  the  relative  position  in  the  tape 
record  under  construction  that  the  left-most  character  of  the 
field  is  to  occupy.  The  first  such  position  is  location  oero. 

Each  field  (or  string  of  contiguous  characters)  that  is  to  be  trans¬ 
ferred  from  an  output  card  to  the  tape  record  must  be  specified  in  the 
above  manner. 

EKD  as  a  3-character  word  standing  alone  terminates  the  LOAD  specifica¬ 
tions  and  initiates  the  LOAD  operation. 

A  complete  set  of  LOAD  specification. cards  are  presented  below. 
Essential  terms  are  underlined.  All  words,  other  than  the  three 
control  words  previously  described,  are  noise  words  that  have  been 
included  to  provide  more  readable  specifications. 
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IjOAD  FILE  1  TAPE  2  FROM  CARDS 
CARD  SET  IDENT  IS  IN  COLUMN  77 
FOR  4  COLUMNS 

CARD  NUMBER  IS  IN  COLUMN  7%  FOR  2  COLUMNS 

FIELDS  TO  BE  INCLUDED  ARE  AS  FOLLOWS 

CARD  1  START  1  SIZE  10  AT  0 

CARD  1  START’  21  SIZE  ^0  AT  10 

CARD  2  START  1  SIZE  jjO  AT  40 

CARD  3  START  6^  SIZE  £  AT  70  END 

In  the  above  example,  each  record  on  tape  would  contain  40  characters 
from  card  number  1  at  positions  0  thru  39  and,  if  cards  2  and  3  were 
present,  30  characters  from  card  2  at  position  40  thru  69  and  5 
characters  from  card  3  at  position  70  thru  74. 

If  cards  1  or  2  were  missing,  positions  0  thru  49  or  positions  40 
thru  69  would  contain  blanks.  If  card  3  were  missing,  the  record 
would  be  truncated  at  position  69.  If  cards  2  and  3  were  missing, 
the  record  would  be  truncated  at  position  39* 

If  the  optional  terms  NUMBER  75,2  in  the  example  were  not  provided, 
and  cards  1  and  2  were  missing  or  out  of  order,  the  first  card  of  the 
identified  set  that  was  encountered,  in  this  case  card  3/  would  be 
treated  by  the  program  ar  if  it  were  card  1,  the  second  as  card  2  and 
so  on.  If  the  optional  terms  IDENT  77,4  in  the  example  were  not 
specified,  each  card  encountered  would  be  treated  a3  card  1. 

Input  to  the  LOAD  operation  in  limited  to  80-column  punch  cards 
either  via  the  card  reader  or  from  a  previously  stored  magnetic  tape. 

Output  record  size  is  adjusted  by  the  system  to  accommodate  the  fields 
that  have  been  specified.  The  standard  maximum  record  size  accepted 
by  all  functions  of  the  MADAM  System  is  1000  characters;  however, 
records  up  to  4000  characters  may  be  generated  by  MADAM  to  provide 
input  to  other  systems  or  programs.  When  the  NUMBER  option  is  not 
used,  data  cards  that  are  to  be  input  to  th'e  .LOAD  operation  mu3t  be 
ordered  within  any  card  set  to  assure  correct  loading.  An  end  of  » 
file  card  (GROUP  MARK  character  in  column  l)  must  terminate  the  deck. 
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The  BLOCK  Operation 

The  BLOCK  operation  provides  a  means  of  reorganizing  and  restructuring 
a  data  file  on  magnetic  tape.  A  structured  file  is  first  ordered  with 
respect  to  desired  key  fields  via  the  SUBSET  and  SORT  operations.  The 
key  field  is  identified  to  the  BLOCK  process  as  the  KEY  data  set 
identity  field.  Data  fields  from  the  old  file  that  are  to  be  included 
in  the  new  file  are  identified  to  the  BLOCK  operation  as  data  ITEMS. 

The  BLOCK  operation  will  group  selected  fields  from  records  in  the 
old  file  that  have  the  same  KEY  into  a  single  record  in  the  new  file. 

The  data  set  identity  field  will  be  included  as  the  first  field  in 
the  new  record.  In  order  to  provide  user  control  of  the  maximum-size 
record  that  will  be  generated,  a  parameter  SIZE  is  provided  as 
described  below. 

The  BLOCK  operation  may  be  used  in  a  more  straightforward  way  to  group 
unrelated  data  elements  into  larger  physical  records  by  specifying 
only  the  maximum  SIZE  and  ITEMS  to  be  included,  leaving  the  data  set 
identity  KEY  unspecified. 

The  BLOCK  operation  is  initiated  by  a  declaration  in  the  form: 

BLOCK  (output  file  designation)  (input  file  designation) 

Example: 

BLOCK  FILE  1  TAPE  4  FROM  FIIE  5  TAPE  2 
BLOCK  1,4  FROM  5,2 

Cards  are  not  a  permissible  input  form  to  the  BLOCK  operation.  Four 
English  words  modify  the  operation  of  the  BLOCK  function: 

KEY  introduces  two  numeric  1  indicators.  The  first  number  is  interpreted 
as  the  left-most  relative  address  (or  lowest-valued  address)  occupied  by 
a  data  set  identity  field.  The  second  specifies  the  number  of 
character  positions  occupied  by  the  data  set  identity  field.  Records 
having  the  same  data  set  identity  are  grouped  together  in  a  single 
blocked  record  up  to  the  maximum  specified  block  size.  The  data  set 
identity  KEY  will  be  included  in  the  output  record  occupying  relative 
position  zero  through  as  many  characters  as  are  required.  The  use  of 
the  term  KEY  to  effect  data  set  identity  blocking  is  optional.  Data 
records  will  be  blocked  independently  of  content  if  no  reference  to 
KEY  is  made. 
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SIZE  introduces  a  single  numeric  indicator  that  specifics  the  maximum 
number  of  character  positions  to  be  included  in  any  clocked  record. 
Specified  items  or  fields  from  each  input  record  will  be  included  in 
the  block  being  prepared  until  the  addition  of  the  data  from  a  sub¬ 
sequent  input  record  would  cause  the  SIZE  parameter  to  be  exceeded. 

IT'.  13  Introduces  recurring  pairs  of  numbers  that  specify  the  relative 
starting  address  (left-most  character  position)  and  size  (number  of 
characters)  for  each  item  or  field  of  the  input  record  that  is  to  be 
included  in  the  output  blocked  record. 

END  us  a  3-character  word  standing  alone  terminates  the  BLOCK  specifi¬ 
cations  and  initiates  the  BLOCK  operation. 

A  sample  set  of  BLOCK  specifications  are  presented  below.  Significant 
terms  and  parameters  are • underlined.  All  other  words  are  noise  words 
whose  only  purpose  is  to  enhance  readability. 

BLOCK  FILE  2  TAPE  2  FROM  FILE  TAPE  b 

TO  SIZE  2450 

THE  DATA  SET  KEY  OCCUPIES  POSITION 

T6  AND  TS  b  CHARACTERS  LONG 

ITEMS  TO  BE  INCLUDED  ARE 

START  0  SIZE  10 

START  21  SIZE  2L 

START  J50  SIZE  _IA  END 

Each  block  resulting  from  the  example  specification  will  contain  a 
data  set  KEY  at  position  0  thru  3,  and  as  many  following  LT-character 
sets  of  input  data  as  possess  the  same  value  of  the  data  set  KEY. 

The  maximum  block  would  include  5 2  such  input  sets. 

Input  to  the  BLOCK  operation  is  assumed  to  be  from  magnetic  tape. 

Input  records  can  be  as  large  as  1000  characters.  Output  records  car. 
be  as  large  as  3!300  characters.  Records  o'f  1000  characters  are 
maximum  for  subsequent  MADAM  operations,  however. 
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3-  The  SORT  Operation 

The  SORT  process  permits  records  within  u  file  to  be  ordered  in 
alphabetic  and/or  numeric  sequence  with  reference  to  key  fields  that 
are  specified  by  the  user.  See  Appendix  A  for  1401  collating  sequence. 

The  SORT  operation  is  initiated  by  a  declaration  in  the  form: 

SORT  (input  file  description)  BY  (major  key  field)  AND  (minor 
key  fields) 

Example : 

SORT  FILE  2  TAPE  2  BY  0,5  AND  5,1  AND  6,10  AND  79,1  END 

Input  to  the  SORT  operation  is  assumed  to  be  a  file  on  magnetic  tape. 

The  following  terms  control  the  operation  of  SORT: 

END  as  a  3-character  word  terminates  the  SORT  specification  and 
initiates  the  SORT  operation. 

BY  introduces  the  first  of  up  to  five  sets  of  parameters,  the  sets 
being  connected  by  the  term  AND.  The  first  character  of  such  a  (set 
specifies  the  relative  starting  (or  left -most)  character  position, 
in  the  records  to  be  sorted,  occupied  by  a  field  to  be  used  as  e  sort 
key.  The  second  parameter  in  a  set  states  tht  number  of  characters 
that  make  up  the  key.  A  third  numeric  parameter  within  any  parameter 
set  is  considered  to  represent  the  maximum  size  (number  of  characters) 
of  a  tape  record  to  be  sorted.  This  third  parameter  may  occur  in 
any  parameter  set,  where  more  than  one  set  is  steted  and  need  occur 
only  once  in  any  SORT  specification.  It  is  used  by  the  first  phase 
of  the  SORT  process  to  allocate  core  memory  for  internal  sorting. 

When  a  third  parameter,  as  above,  is  not  provided  by  a  user,  1000 
characters  are  assumed  as  the  maximum  tape  record  s^ze.  Sort  keys 
are  specified  in  descending  hierarchical  order  of  data  organization. 

■Hie  major  sort  key  follows  the  term  BY  and  so  cn.  Up  to  five 
hierarchical  sort  keys  may  be  declared  in  one  SORT  operation. 

A  sample  SORT  specification  is  presented  below  with  significant  terras 
underlined. 
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Input  atid  output  records  may  be  of  variable  length  but  must  not 
exceed  1000  characters.  Sort  keys  must  occupy  identical  relative 
positions  in  all  records.  Output  will  consist  of  a  file  on  magnetic 
tape  in  lUOl  collating  sequence  of  sort  keys.  The  sorted  file  will 
be  the  first  file  on  the*-,  tape.  The  unit  selected  for  output  will  be 
the  unit  upon  which  the  input  was  provided.  In  the  above  example, 
output  will  be  on  FILE  1  TAPE  2. 

During  the  SORT  operation  the  term  PAUSE  occurring  anywhere  between 
the  terms  SORT  and  END  will  be  interpreted  as  a  request  for  a  system 
halt  at  the  completion  of  the  first  or  distribution  pass  and  a 
message  will  be  printed.  Operation  is  resumed  when  the  operator 
presses  START. 

If .  The  COPY  Operation 

The  COPY  operation  provides  capability  for  uuplicating  data  files 
between  reels  of  magnetic  tape.  The  COPY  operation  is  initiated  by 
a  declaration  in  the  form: 

COPY  (output  file)  (input  file) 

For  example : 

COPY  FILE  1  TAPE  3  FROM  FILE  2  TAPE  2 
COPY  NEXT  FILE  TAPE  3  FROM  NEXT  FILE  TAPE  2 
COPY  1,3  FROM  2,2 

There  are  no  English  terms  that  modify  the  COPY  operation. 

Input  is  from  magnetic  tape  and  may  consist  of  variable  length 
records  up  to  LOOO  characters  in  length.  Output  is  to  magnetic 
tape  with  similar  limitations. 

3.  The  COMBINE  Operation 

The  'OMBINK  operation  permits  any  number  of  files  from  a  reel  cf 
magnetic  tape  to  be  placed  on  another  reel  of  magnetic  tape  as  one 
file.  The  COMBINE  operation  is  initiated  by  a  declaration  in  the 
farm  ■ 

COMBINE  (output  file)  (initial  input  file) 
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Example: 

COMBINE  FILE  2  TAPE  3  "POM  FILE  1  TAPE  2 
COMBINE  2,3  FPOM  1,2 
Input  and  output  are  Tor  magnetic  tape. 

Two  English  wordr.  modify  the  operation  of  the  COMBINE  function: 

SKIP  introduces  one  or  many  numeric  parameters.  These  are  interpreted 
no  sequential  file  identity  numbers  for  files  from  the  input  tape 
that  are  to  be  excluded  from  combination.  The  use  of  SKIP  is  optional. 

TERMINATE  introduces  a  single  numeric  indicator  representing  the 
sequential  file  identity  number  of  the  last  file  from  the  input  tape 
to  be  included  in  the  output  file. 

Input  and  output  files  may  consist  of  variable  length  records  up  to 
4000  characters  long. 

COMBINE  FILE  1  TAPE  4  FROM  FILE  1 

TAPE  3  SKIP  FILES  2,4,6,  TERMINATE 

AFTER  FILE  7 

6.  The  POSITION  Operation 

Each  of  the  MADAM  operations  described  above  position  a  specified 
magnetic  tape  to  a  sequential  file  prior  to  the  process.  It  is 
sometimes  convenient  to  perform  magnetic  tape  file  positioning 
independently.  The  POSITION  operation  is  provided  for  this  purpose. 

One  to  three  magnetic  tapes  cn  separate  tape  handlers  may  be 
positioned  with  a  single  POSITION  operation. 

For  example: 

POSITION  1,2  END 

POSITION  FILE  1  UNIT  2,  Fill:  3  UNIT  3  END 
POSITION  1,2, 1,3, 1,4' END 
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The  third  and  last  example  above  can  be  employed  to  rewind  three 
reels  at  the  end  of  a  MADAM  Job.  The  POSITION  operation  may  be  used' 
to  assign  input-output  units  to  an  operation.  In  this  case  the 
POSITION  specification  is  not  terminated  by  an  END  term.  For 
example : 

POSITION  1,2  FROM  CARLS 
FORMAT 

READ  WRITE  IN  0,80  END 
will  be  interpreted  same  as: 

FORMAT  1,2  FROM  CARDS 
READ  WRITE  IN  0,  80  END 

The  first  form  above  can  be  used  with  the  CATALOG  and  CALL  operation 
described  elsewhere  in  this  manual  to  effect  input-output  unit 
assignment  and  re-assigpment  for  the  same  specification. 

There  are  r.o  modifying  words  affecting  the  POSITION  function. 

7.  The  OPERATE  Function 

The  OPERATE  function  may  be  used  to  load  and  execute  any  compatible 
lUOl  program. 

Program  features  that  determine  compatibility  with  the  MADA.M  system 
are : 

a.  The  program  must  be  in  AUTOCODER  condensed  card  form,  eitner 
as  a  deck  or  prestored  as  a  file  on  tapt. 

The  program  must  be  compiled  to  occupy  core  memory  locations 
35l  and  higher. 

The  program  must  return  control  to  the  MADAM  system  through 
the  following  AUTOCODER  instruction  set  or  its  equivalent: 


RWD 

1 

rewind  unit  1 

RTW 

1,1 

read  the  first  record  from  unio  1  into 
location  1 

B 

31 

Branch  to  location  31 
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d.  The  program  must  obtain  object  data  from  a  file  and  place 
its  output  into  a  file.  No  provision  is  made  for  core 
memory  storage  of  data  to  be  communicated  between  programs. 

When  the  program  to  be  operated  contains  AUTOCODER  clear  core 
cards  1  and  2,  the  OPERATE  function  performs  the  clearing  operation 
in  a  way  that  preserves  MADAM  operation  parameters. 

OPERATE  specifications  tak£  the  following  form: 

OPERATE  (file  declaration) 

OPERATE  CARDS  causes  a  following  AUTOCODER  condensed  program  deck 
to  be  loaded  and  executed.  OPERATE  2,4  causes  the  second  file 
from  tape  unit  four  to  be  treated  as  a  prestored  AUTOCODER  condensed 
program  deck  for  loading  and  execution. 

OPERATE  NEXT,  6  may  be  used  in  conjunction  with  the  CATALOG  and  CALL 
operations  described  elsewhere  in  the  manual  to  place  a  non-system 
program  into  the  system  library  and  call  it  into  execution  oy  name. 

B.  MADAM  LIBRARY  Operations 

The  LIBRARY  operations  provide  a  capability  for  placing  card  sets  into 
a  library  file.  Each  such  card  set  is  given  a  distinguishing  name 
at  the  time  of  insertion.  Named  card  sets  may  be  retrieved  for  subse¬ 
quent  processing. 

Card  sets  in  the  MADAM  library  may  contain: 

(1)  Complete  MADAM  specifications  including  compatible  1401  programs. 

(2)  Comments. 

(3)  Combinations  of  1  and  2  above. 

(4)  Partial  MADAM  specifications  or  comments  (legal  only  in  the 
CATALOG  mode,  see  below). 

LIBRARY  operations  occur  in  two  modes : 

(1)  The  CATALOG  mode  in  which  card  sets  are  retrieved  for  loading  into 
a  library  file  in  association  with  an  identifying  card  set  name. 

(2)  The  EXECUTE  mode  in  which  named  card  sets  are  retrieved  for  transla¬ 
tion  and  execution  by  the  MADAM  processes.  In  the  EXECUTE  mode, 
card  sets  are  assumed  to  represent  executable  complete  MADAM 
specifications,  compatible  1401  programs,  or  groups  of  same. 
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The  EXECUTE  mode  is  the  normal  operating  mode  of  the  MADAM  system. 
The  CATALOG  mode  is  entered  when  u  CATALOG  specification  occurs. 

The  MADAM  library  consists  of  a  single  file  containing  sequential 
80  character  card  records.  The  file  is  terminated  by  a  single  1401 
end-of-file  marker. 

The  following  operations  may  be  performed  on  the  library  file: 

O'  The  operation  LIBRARY  is  used  to  initiate  or  open  a  library 
file.  The  LIBRARY  specification  takes  the  form: 

LIBRARY  (file  declaration) 

LIBRARY  1,6  opens  a  library  file  a3  file  ly  unit  6.  Tupe  unit  6 
is  rewound  to  load  point  and  a  single  end-of-file  mark  written 
as  the  first  record. 

LIBRARY  CARDS  opens  a  library  file  in  punched  card  form.  No 
initializing  actions  are  taken  other  than  to  identify  the  output 
form  as  punched  cards.  The  LIBRARY  operation  is  used  only  when 
a  new  library  file  is  to  be  built.  File  1  unit  6  is  implicitly 
defined  in  the  MADAM  system  as  the  operating  library. 

No  LIBRARY  specification  is  needed  to  add  new  card  sets  into  the 
operating  library  on  file  1,  unit  6. 

(2 )  The  CATALOG  operation  is  used  to  insert  a  named  card  set  into  an 
existing  library.  The  CATALOG  specification  takes  the  form: 

CATALOG  (card  set  name)  where  card  columns  1-7  of  the 
specification  card  contain  the  terra  CATALOG,  card 
columns  9-18  contain  a  user  specified  unique  card  set 
name,  and  card  columns  19-80  may  contain  any  comment  or 
descriptive  text. 

The  CATALOG  specification  card  is  followed  immediately  by  the 
card  set  to  be  catalogued.  The  object  card  set  is  terminated  by 
a  card  containing  MARK  in  card  columns  1-1*. 

At  the  completion  of  a  CATALOG  operation  the  designated  LIBRARY 
file  contains : 

a.  the  CATALOG  card  record 
t  .  the  card  set  as  sequential  card  records 
c •  the  MARK  card  record 
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The  records  above  will  be  added  to  the  library  file  beginning  at 
the  current  record  position  occupied  by  the  end-of-file  record. 

An  end-of-file  record  will  be  written  following  the  MARK  card 
record. 

The  operation  CALL  is  used  to  retrieve  named  card  sets  from  a 
library  file  on  tape  unit  6.  The  library  file  must  be  the  first 
file  on  unit 

The  CALL  specification  take  the  form: 

CALL  (card  set  none) 

Only  one  CALL  specification  per  card  is  allowed.  There  is 
no  requirement  as  to  card  columns  excepting  the  normal  requirement 
for  a  blank  or  comma  between  successive  terms.  'The  first  ten 
characters  only  of  a  card  set  name  are  used  for  retrieval  matching. 

In  the  EXECU3E  mode,  the  CALLed  card  set  is  submitted  directly  to 
the  MADAM  translator  as  executable  MADAM  specifications. 

In  the  CATALOG  mode,  the  CALLed  card  set  is  included  in  sequence 
within  the  total  card  set  being  catalogued.  The  CATALOG  and 
MARK  cards  of  the  CALLed  card  set  are  not  retrieved  from  the 
source  library.  It  is  possible,  in  the  CATALOG  mode,  to  thus 
combine  selected  partial  MADAM  specifications  into  a  con^lete 
specification  for  later  execution  from  tape  1  unit  6. 

For  example : 

LIBRARY  1,6 
CATALOG  PRESTORE 
FORMAT  1,2  FROM  CARDS 
READ  WRITE  IN  0,  80  EOT) 

MARK 

CATALOG  PROG-1 

OPERATE  NEXT,  6 

(1401  compatible  program  deck) 

MARK 

CATALOG  LIST 
PRINT  1,4 

READ  SET  IN  0,  80  AT  0UT  0  PRINT  END 
MARK 
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In  sequence  above: 

a-  A  Library  file  is  opened  cn  tape  unit  6 
b.  The  Job  FRESTORE  is  entered 

c-  The  AUTOCODER  pragma  PHOT. -1  1b  entered  (note  it  is 
the  0FERA^  next,  6  specification  that  actually  effects 
program  execution) 

d.  The  Job  LIST  is  entered 

The  user  aay  then  say: 

CATALOG  JOB  -1. 

CALL  FRESTORE 

CALL  FROG  -I 

MARK 

CATALOG  JOB-1- -A 
CALL  \j  Qa  . 

CALL  LIST 
MARX 

I<ev,  when  the  user  requests: 

CALL  JOB-1.  -A 

All  three  cf  the  original  specifications  above  are  retrieved  for 
execution.  Note  that  a  CALL  within  the  brackets  CATALOG  ar_d  MARX 
is  act  retrieved  for  execution  but  for  inclusion  into  the  library. 
Note  also  that  LIBRARY  1,6  ie  only  specified  where  no  operating 
library  is  currently  on- line  to  the  MADAM  Systen. 

To  copy  the  above  library  onto  another  file: 

LIBRARY  2,k 

CATALOG  PRESTORE 


CALL  PRESTO  RE 
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MARK 

CATALOG  PROG-1 
CALL  PROG- 1 
MARK 

CATALOG  LIST 
CALL  LIST 
MARK 

CATALOG  JOB-1. 

CALL  JOB-1. 

MARK 

CATALOG  JOB-1. -A 
CALL  JOB-1. -A 
MARK 

I 

Any  or  all  ol'  the  catalogued  card  sets  could  have  been  re-named 
In  the  above  example. 
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C.  Procedural  System  Operations 

The  non-procedural  processes  described  previously  operate  iteratively 
upon  each  record  of  the  input  or  output  file.  There  is  a  means  of 
selecting  object  fields  or  records  before  the  fact,  but  no  method  is 
provided  in  those  processes  for  dynamic  re-specification  of  object 
fields  during  operation  bb  a  result  of  changes  in  the  object  data. 

This  is  perhaps  not  too  restrictive  for  the  above  operations  and  has 
the  advantage  that,  because  each  element  of  data  need  not  be  examined 
for  evaluation  purposes,  operatiop  can  proceed  more  rapidly. 

There  exists  a  class  of  operations  upon  data,  however,  that  must  take 
into  account  the  dynamic  nature  of  the  data  being  processed.  These 
conditional  operations  must  be  made  to  perform  a  designated  task  only 
when  certain  conditions  are  manifested  as  a  result  of  data  manipulation 
or  examination. 

In  the  processes  to  be  explained  below,  MADAM  provides  a  useful  range 
of  capability  that  can  be  made  conditional  upon  both  the  logical  and 
physical  nature  of  the  data  as  it  is  dynamically  encountered. 

Conditional  operation  in  MADAM  is  effected  through  the  implementation 
of  two  kinds  of  functions:  tests  and  conditional  actions.  Neither 
function  need  be  particularly  extensive  in  its  range  of  operation. 

Tne  following  tests  can  be  made  in  MADAM. 

(l)  Tests  for  end  of  input  files. 

'2'.  Tests  for  end  of  variable  length  fields  such  as  textual  fields 
and  textual  elements. 

(3'  Tests  determine  the  nature  of  fields: 

a.  Tests  for  a  numeric  field, 

b.  Tests  that  determine  the  relative  collating  sequence  of 
field  configuration  for  two  fields; 

e  Tests  that  determine  the  relative  collating  sequence  of  the 
values  of  two  fields, 

(  ■  Tests  that  permit  format  control  of  printed  output. 
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The  following  kinds  of  conditional  actions  ore  provided: 

Reading  end  writing  of  data  files  from  various  sources, 

Transfer  of  data  fields  within  internal  working  areas; 

Editing  actions  that  permit  fields  to  be  formatted  in  particular 
ways; 

Arithmetic  actions  upon  fields; 

Actions  to  control  the  direct  printer  carriage; 

Actions  to  control  the  sequence  of  execution  of  tests  and  other 
actions; 

Actions  that  permit  dynamic  definition  of  object  fields. 


The  four  MADAM  operations  in  which  tests  and  conditional  actions  can 
be  taken  are:  PRINT,  FORMAT,  SUBSET,  and  ABSTRACT.  In  SUBSET, 
ABSTRACT,  and  FORMAT,  two  output  files  my  optionally  be  produced. 

1.  The  PRINT  operation  is  used  when  the  contents  of  a  data  file 
are  to  be  displayed  in  printed  form  as  in  a  report.  The  data 
file  v/C  be  printed  may  be  sorted  on  magnetic  tape  or  may  be  in 
card  fora.  The  format  of  a  report  prepared  by  the  PRINT  operation 
in  flexible  due  tc  he  nature  of  the  conditional  operations 
employed. 

The  PRINT  operation  is  initiated  by  a  declaration  in  the  form: 

PRINT  (input  file  designation) 

Exajj$>les : 

PRINT  FIU5  2  TAPE  3 
PRINT  CARDS  ' 

The  data  to  be  printed  is  read  into  an  internal  input  storage 
region  referred  to  by  the  user  as  region  IN.  E..ch  line  that  is 
to  be  printed  is  prepared  in  another  storage  region  labelled  OUT. 
Region  OUT  is  large  enough  to  contain  a  full  132-character  line. 
The  operations  performed  during  a  PRINT  are  described  in  detail 
by  the  user  in  a  set  of  operation  specifications  directing  that 
conditional  actions  be  performed. 


28 


TM- 2 198/002/00 


2  December  1965 


2.  The  FORMAT  operation  is  used  when  the  contents  of  a  data  file 
are  to  be  written  onto  a  magnetic  tape  or  punched  into  cards. 

Like  PRINT,  the  data  file  to  be  formatted  may  be  stored  on 
magnetic  tape  or  may  be  in  card  fora.  During  the  FORMAT  operation 
the  full  range  of  capabilities  of  the  PRINT  operation  are  available 
to  the  user.  This  means  that  combination  operations  may  be  done 
at  the  same  time  such  as  printing  and  punching  or  printing  while 
writing  records  onto  tape.  While  printing  can  be  done  only  from 
region  OUT  (.132  characters),  tape  records  may  be  written  from 
regions  IN  (1000  characters)  or  region  OUT. 

The  FORMAT  operation  is  initiated  by  a  declaration  in  the- form: 

FORMAT  (output  file  designations)  (input  file  designation) 
Examples: 

FORMAT  FILE  2  TAPE  3  FROM  FILE  3  TAPE  h 


FORMAT  2,  3'  FROM  CARDS 
FORMAT  CARDS  FROM  CARDS 

FORMAT  1,5  AND  1,3  FROM  1,2  (Where  two  output  files  are  desired) 


Like  PRINT,  the  data  from  the  input  file  is  read  into  an  internal 
storage  region  referred  to  as  region  IN.  The  data  to  be  printed 
is  placed  into  region  OUT  by  conditional  transfer  action.  Data 
to  be  written  onto  tape  or  punched  into  cards  may  remain  in 
region  IN  or  be  transferred  to  region  OUT  optionally.  The  WRITE 
action  is  performed  from  a  specified  region.  The  full  range  of 
conditional  operations  explained  in  the  following  paragraphs  may 
be  employed  in  FORMAT  or  a  PRINT  operation. 

PRINT  and  FORMAT  Actions 

Actions  that  may  be  taken  during  a  PRINT  or  FORMAT  operation  are 
listed  below  with  some  explanation  as  to  their  effect  on  the 
object  data. 

ACTION  '  EFFECT 

READ  The  next  record  fran  the  designated  input  file 

(tape  or  cards)  is  read  into  region  IN  beginning 
at  relative  position  IN  0.  A  GROUP  MARK  (12-7 “8 
punch)  is  placed  ir.  region  IN  following  the  last 
data  character  read  in.  The  COLUMN  counter  is 
incremented. 
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ACTION 
READ  100 


WRITE  IN 

WRITS  IN 

PRINT 

SKIP  1 

RESTORE 


EFFECT 


The  next  record  from  the  designated  input  file 
(tape  or  cards)  is  read  into  region  IN  at 
location  IN  0.  A  check  is  then  made  to  see 
if  at  least  100  characters  ar*;  present  ir.  the 
region.  If  not,  the  next  record  is  read  in 
following  the  first  and  so  on  until  100 
characters  are  present. 

On  the  next  READ  100  action,  any  characters  in 
excess  of  100  that  were  previously  read  are 
saved  at  position  IN  0  and  the  next  record 
is  read  in  following  them  and  so  on  as  above. 
The  COLUMN  counter  is  incremented. 

•,  80  The  80  characters  beginning  with  the  character 

at  position  IN  0  are  transferred  to  the 
designated  output  file  ns  the  next  record. 
Characters  in  region  IN  ure  not  changed. 

GROUP  MARX  characters  in  region  IN  will 
terminate  the  WRITE  operation.  ' 

,80  Similar  to  WRITE  IN  0,80  except  the  second 

designated  output  file  receiver  the  transferred 
data.  (The  second  output  file  designation  is 
linked  to  the  first  by  the  terra  AND.  Not  legal 
during  PRINT  operation. ) 

Data  in  region  OUT  0  thru  OUT  Ljl  are  printed 
as  the  next  line  on  the  direct  printer  page. 
Region  CUV  0  :..rw  1 3 1  is  cleared  cc  blanks. 

The  LINE  counter  is  incremented. 

The  next  line  on  the' direct  printer  page  ir 
bypassed  and  the  LINE  counter  incremented. 

This  action  starts  a  new  puge.  The  direct 
printer  carriage  Is  positioned  to  conform  to  a 
punch  in  channel  1  of  the  carriage  centre1 
tape.  The , standard  carriage  control  tore  is 
so  prepared  ns  to  position  the  puper  t.  * 
top  of  the  uext  puge.  The  PAGE  counter  ir 
incremented  and  the  LINE  counter  set  to 
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ACTION 
REPORT  55 


GET  (01)  AT  TEMP  1 

ADJUST  (012)  AT  TEMP 


ALIGN  (012)  AT  TEMP  1 


EFFECT 


This  is  an  action  that  permits  the  user  to 
specify (other  than  60  lines  per  page.  In 
the  example,.  55  lines  arc  desired.  An 
internal  register  is  set  to  55-  If  the  LINE 
counter  attains  a  value  of  55  or  more  and,  the 
PRINT  or  FORMAT  specifications  permit,  an 
automatic  RESTORE  action  is  taken. 

NOTE:  The  automatic  RESTORE  will  not  function 
unless  the  PRINT  or  FORMAT  specifications  are 
written  3uch  that  the  END  (end  of  specifications) 
term  is  executed.  Should  the  user  restrict  the 
execution  of  the  END  term  by  interposed  loops 
via  the  DO  action,  he  must  provide  page  control 
actions  in  his  specifications. 

0 

The  two  characters  enclosed  in  parentheses, 

”0.1, "  are  transferred  to  region  TEMP  with  the 
digit  "0"  occupying  relative  position  TEMP  .1 
and  the  digit  "l"  relative  position  TEMP  2. 

The  three  characters  enclosed  in  parentheses, 
"012,"  are  examined  and  leading  zeros  and/or 
all  blanks  are  removed  from  the  field  The 
remaining  characters,  in  this  case  the  digits 
"12,"  are  transferred  to  region  TEMP  such 
that  the  right-most  character  ”2"  occupies 
relative  position  TEMP  1  and  the  preceding 
character  "l"  relative  position  TEMP  0. 

Leading  zeros  and/or  all  blanks  arc  removed 
as  above.  The  remaining  characters,  "12," 
are  positioned  to  region  TEMP  with  the  digit 
"1"  nt  TEMP  l  and  the  digit  "2"  at  TEMP  2. 

An  end-of-file  is  written  on  any  output  tape 
and  return  is  made  to  MADAM  Gy stem  control 
where  the  card  reader  is  monitored  for  a  new 
specification. 


STOP 
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ACTION 

COMPUTE  IN  0,5 


+  IN  0,3 


-  (5) 


*  OUT  5,3 

/  IN  3,2 


$  IN  3,2 


-  OUT  0,5 


EFFECT 

The  10-digit  arithmetic  accumulator  (RESULT) 
is  cleared  to  zero  and  the  5  characters  at 
IN  0  thru  IN  U  are  added  as  integers .  COMPUTE 
with  an  object  data  field  greater  than  10 
characters  in  length  will  cause  standard  1U01 
overflow  bits  to  be  generated  at  position 
RESULT  0.  COMPUTE  is  valid  with  a  literal 
object  such  as  COMPUTE  (0) .  This  would  have 
the  effect  of  clearing  and  adding  (0)  to  the 
accumulator. 

The  3  characters  at  IN  0  thru  IN  2  are  added 
to  the  current  contents  of  the  10  digit  arith¬ 
metic  accumulator  (RESULT).  Overflow  may 
occur  as  in  COMPUTE. 

The  1  character  literal  value  ”5"  is  sub¬ 
tracted  from  the  current  contents  of  the 
10  digit  accumulator  (RESULT).  If  the  result 
is  negative  the  units  position,  RESULT  9," 
will  have  a  minus  (or  11  zone).  A  positive 
result  will  have  no  zone  bits  at  RESULT  9* 

The  current  contents  of  the  10  digit  accumula¬ 
tor  (RESULT)  are  multiplied  by  the  3  character 
value  at  OUT  5  thru  OUT  7*  Overflow  may  occur. 

(The  current  contents  of  the  10  digit  accumula¬ 
tor  (RESULT)  are  divided  by  the  2  character 
value  at  IN  3  thru  IN  4.  The  integral  portion 
of  the  quotient  is  left  in  the  accumulator. 

Any  remainder  may  be  found  in  a  10  digit  field 
(REMAINDER)  as  an  integer. 

The  current  contents  of  the  10  digit  accumula¬ 
tor  (RESULT)  are  divided  by  the  2  character 
value  at  IN  3  thru  IN  U .  The  remainder  is 
left  in  the  accumulator  as  an  integer.  'Die 
quotient  is  destroyed. 

The  5  least  significant  characters  of  tin- 
current  contents  of  the  10  digit  accumulator 
(RESULT)  are  transferred  to  OUT  thru  OUT  L, 

The  value  in  the  accumulator  is  unchanged. 
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=  OUT  0,20 


SCAN  IN  0,80 
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EFFECT 


The  10  digits  of  current  accumulator  contents 
are  transferred  to  OUT  10  thru  OUT  19.  The 
value  in  the  accumulator  is  unchanged.  The 
data  characters  at  OUT  0  thru  OUT  9  are  not 
affected. 

The  80  characters  at  IN  0  thru  IN  T9  are 
identified  as  a  textual  field.  Only  one 
textual  field  may  be  scanned  at  a  time; 
however,  textual  field  identification  may  be 
dynamically  changed  during  any  process.  On 
the  first  occurrence  of  the  terms  "NEXT  VOD, " 
a  word  will  be  sought  beginning  at  IN  0  and 
proceeding  towards  IN  79  until  a  word 
separator  character,  or  position  IN  80,  is 
reached.  At  this  point,  the  string  of 
characters  isolated  has  its  starting  position 
and  size  identified.  Subsequent  reference  to 
"WORD"  will  cause  the  identified  data  string 
to  be  operated  upon. 


The  following  regions  may  be  referred  to  in  the  PRINT  and  FORMAT 
operations . 


REGION 

SIZE 

CONTENT 

IN 

1000  char. 

Contains  an  input  record  as  a  result  of  a 

READ  action.  May  be  used  for  other  storage. 

OUT 

132  char. 

May  be  loaded  with  data  to  be  printed, 
punched,  or  written  onto  magnetic  tape. 

TEMP 

200  char. 

May  be  used  for  temporary  storage .  Contains 
index  values  for  the  prime  operation.* 

REMAINDER 

10  char. 

Contains  remainder  after  a  divide  action. 

TERM 

6  char. 

Positions  0  thru  4  contain  up  to  five  legal 
word  separator  characters  as  specified  for  the 
text  scanning  action.  Position  5  contains  the 
last  word  separator  actually  encountered  during 
scanning. 

RESULT 

10  char. 

Accumulates  arithmetic  results. 

* 

The  prime  operation  is  explained  on  page  >1. 
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REGION 

SIZE 

CONTENT 

COLUMN 

3  char. 

Input  record  counter. 

PAGE 

3  char. 

Page  counter. 

LINE 

3  char. 

Line  counter. 

3.  The  SUBSET  operation  is  used  when  the  contents  of  a  data  file  are  to  be 
selectively  transferred  onto  an  output  magnetic  tape  file  or  files  and  the 
input  and  output  data  require  more  than  1000  characters  for  storage. 

Records  up  to  1000  characters  in  size  can  be  handled  during  a  FORMAT 
operation.  Records  up  to  3000  characters  in  size  can  be  handled  by  SUBSET. 
Because  the  space  available  in  MADAM  program  storage  is  limited,  the  actions 
provided  in  PRINT  and  FORMAT  for  printing  and  for  textual  processing  have 
been  sacrificed  in  SUBSET  in  order  to  provide  for  larger  output  records. 

I 

The  SUBSET  operation  is  initiated  by  a  declaration  in  the  form: 

SUBSET  (output  file  designations)  (input  file  designation- -INPUT  A) 
Examples : 

SUBSET  FILE  1  TAPE  2  FROM  FILE  2  TAPE  3 

SUBSET  1,2  FROM  2,3 

SUBSET  1,2  and  1,4  FROM  2,3 


The  input  file  to  the  SUEGET  operation  may  be  on,  magnetic  tape  or  in  card 
form.  The  output  from  a  SUBSET  operation  may  be  punched  into  cards  rather 
than  written  onto  tape.  In  the  cas'.  of  punched  card  output,  only  the  last 
(or  right-moat)  80  characters  of  the  object  field  as  specified  in  the  WRITE 
or  WRITB  action  will  be  transferred  to  cards.  The  SUBSET,  operation  requires 
only  a  single  input  file.  The  data  *Vnm  the  file  designated  as  input  A  are  read 
via  a  READA  action  into  internal  region  TNA  com ...cir.g  a*,  position  INA  0.  During 
an  ABSTRACT  operation,  _  L..o  data  from  iftput  B  is  placed  in  region  1ND  in  a 
similar  manner.  The  action  READB  and  the  test  "IF  ENDB"  relating  to 
operation  with  a  second  input  file,  as  in  the  ABSTRACT  operation  below,  are 
not  valid  for  the  SUBSET  operation.  The  region  INB  may  be  used  during 
SUBSET,  however,  for  working  storage. 


4.  The  ABSTRACT  operation  io  used  when  two -input  files  are  to  be  matched  and/ 
or  selectively  processed  such  that  records  from  cither  or  a  combination  of 
both  files  go  to  make  up  the  output  file  or  files.  Tills  is  usually 
accomplished  by  one  input  file  serving  a3  the  index  or  selector  of  data 
from  the  other  input  file.  As  in  SUBSET,  textual  processing  und  printing 
have  been  traded  for  data  capacity  of  3000  characters. 
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The  ABSTRACT  operation  is  inititated  by  a  declaration  in  the  form: 

ABSTRACT  (output  file  designations)  (input  file  designation-- 
INPUT  A)  (index  or  selector  file  designation — INPUT  B) 

Examples: 

ABSTRACT  FILE  1  TAPE  4  FROM  FILE  3  TAPE  3  BY  FILE  1  TAPE  2 

ABSTRACT  1,4, 3, 3,1,2 

ABSTRACT  1,4  FROM  1,3  by  CARDS 

ABSTRACT  1,2  AND  1,4  FROM  1,3  BY  CARDS 

The  names  "input  file"  for  input  A  and  "index  or  selector  file"  for 
input  B  are  arbitrary.  During  an  ABSTRACT  operation  the  data  from  either 
input  A  or  input  E  may  be  employed  as  selector  criteria,  and  furthermore 
data  from  either  A  or  B  may  be  selected  for  output. 

The  "input  file"  or  input  A  is  read  via  a  READA  action  into  region  INA. 
End-cf-file  for  input  A  is  tested  with  an  "IF  ENDA"  test.  The  "index  or 
selector  file"  or  input  B  is  read  via  a  READS  action  into  region  INB. 
End-of-file  for  input  B  is  tested  with  an  "IF  ENDB"  test.  Either  of  the 
two  input  files  may  be  in  card  form.  The  output  may  be  written  onto 
punched  cards  as  in  SUBSET. 

SUBSET  and  ABSTRACT  Actions 

Actions  that  may  be  taken  during  a  SUBSET  or  ABSTRACT  operation  are,  for 
the  most  part,  the  same  as  those  for  PRINT  and  FORMAT.  Only  differences 
and  exceptions  are  listed  below. 

The  following  actions  in  PRINT  and  FORMAT  arc  excluded  from  use  in  SUBSET 
and  ABSTRACT. 


PRINT 

REPORT 

SKIP 

SCAN 

RESTORE 

!t  -an  oe  aeon  that  actions  relating  to  direct  printing  and  to  textual 
processing  are  not  provided.  Data  regions  relating  to  these  actions  are 
also  eliminated.  The  MADAM  terms  COLUMN,  TERM,  MORE,  PAOE,  LINE,  WORD, 
SUFFIX,  PREFIX,  PRINT,  REPORT,  SKIP,  RESTORE,  and  SCAN  are  all  Inoperative 
•  luring  n  SUBSET  or  ABSTRACT  operation. 
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Ine  following  regions  may  be  referred  to  in  the  SUBSET  and  ABSTRACT 
operations . 

REGION  SIZE  .  CONTENT 

IRA  1000  char.  Contains  an  input  File  A  record  as  a  result 

of  a  READA  action.  May  be  used  for  other 
storage  as  well. 

IKB  1000  char.  Contains  an  input  File  B  record  as  a  result 

of  a  READS  action.  May  be  used  for  other 
storage. 

OUT  1000  char.  May  be  used  to  prepare  output  data  records. 

TEMP  100  char.  May  be  used  for  temporary  storage.  Contains 

index  values  for  the  PRIME  operation. 

RESULT  10  char.  Accumulates  arithmetic  results. 

REMAINDER  10  char.  Contains  remainder  following  a  divide  action 

(Operator  /). 

The  four  operations  above  have  many  functions  in  common,  and  therefore, 
utilize  common  language  terms  to  effect  control.  For  these  operations, 
MADAM  terms  can  be  separated  into  five  classes: 

t 

(1)  Action  terms; 

(2)  Condition  terms; 

( 3 ;  Data  terms ; 

(*0  Language  structure  terms; 

(5)  Special  terms. 

Action  Terms 

An  action  term  must  have  an  object  in  order  to  complete- its  meaning. 
Objects  of  action  terms  are  normally  data  field  descriptions  which  are 
composed  of  data  terms.  For  example,  the  action  statement  "SET  IN  0, 

25  AT  OUT  20"  has  the  action  term  SET,  and  the  duti  terms  IN,  0,  25, 

OUT  and  20. 
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Data  terms  are  normally  grouped  together  to  provide  a  complete'  description 
of  a  data  field.  In  the  example  above,  "IN  0,  25"  identifies  the  data 
field  in  region  IN  starting  at  relative  position  0  in  that  region  and 
comprising  25  characters.  'CUT  20"  identifies  relative  position  20  in 
region  OUT  as  the  starting  location  of  the  destination  field. 

Actions  that  imply  movement  or  transfer  of  data  require  both  an  object 
and  a  destination.  ADJUST,  ALIGN,  and  SET  are  transfer  actions  and 
require  an  object  field  description  and  destination  description.  The 
terms  ♦,  -,  *,  /,  »,  and  COMPOTE  specify  arithmetic  actions  and  require 
only  data  field  descriptions  as  objects. 

SCAN  and  WRITE  or  WRITB  also  repuire  only  a  field  description  as  their  object. 
READ,  READA,  READS,  PRINT,  SKIP,  REPORT,  and  RESTORE  provide  user  control 
of  data  input  and  ou^/ut  operations  where  applicable.  No  object  data 
field  is  required,  although  most  of  these  actions  are  subject  to  finer 
definition  by  means  of  a  numeric  parameter.  "SKIP  2,"  for  example, 
causes  two  lines  to  be  left  blank  on  the  printed  output  page. 

The  system  terms  ABSTRACT,  BLOCK,  COMBINE,  COPY,  FORMAT,  LOAD,  POSITION, 

PRINT,  SORT,  and  SUBSET  are  in  reality  action  terms  requiring  data  file 
descriptions  as  objects. 

Language  Structure  Terms 

The  action  DO  takes  a  label  as  its  object.  Labels  are  language  structure 
terms  that  act  to  mark  a  particular  place  in  a  MADAM  specification.  The 
DO  action  is  like  a  branch  or  Jump  instruction  in  a  general  purpose 
computer.  As  a  result  of  the  DO  action,  the  listed  sequence  of  MADAM 
tests  and  actions  is  terminated  and  taken  up  at  the  particular  place  in 
the  specifications  marked  by  the  object  label. 

Labels  are  also  used  to  mark  the  termination  of  a  string  of  conditional 
actions.  For  this  purpose  a  label  has  the  same  meaning  as  the  word 
otherwise"  in  normal  discourse.  Examples  of  the  use  of  labels  are  given 
in  section  F. 

Condition  Terms 


The  tens  IF  is  a  condition  term.  IF  introduces  a  condition  statement  or 
test.  Condition  statements  are  followed  insnediately  by  actions  to  be 
performed  if  the  condition  is  true.  If  the  tee ted  condition  ie  false, 
the  system  continues  operation  at  the  next  IF  statement  in  sequence  or 
the  next  label,  as  indicated  above.  Conditional  expressions  take  the 
form:  IF  (object  field)  relationship  (referent  field). 
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Condition  statements  in  this  form  may  be  strung  together  to  construct 
complex  expressions  of  multiple  conditionality  through  the  use  of  the 
terms  AND  and  OR  to  replace  the  term  IF  in  all  but  the  first  statement 
of  the  string. 

Conditions  connected  by  AND  must  each  be  satisfied  for  the  related  action 
to  take  place.  Conditions  connected  by  OR  may  alternatively  be  satisfied 
for  the  related  action  to  be  performed.  .  For  example,  the  statement 
"IF  A  and  B  or  C  and  D"  will  be  true  when: 

I 

1.  Both  A  and  B  are  true  regardless  of  C  and  D. 

2.  Both  C  and  D  are  true  regardless  of  A  and  B. 

The  statement  is  false  for  all  other  conditions. 

The  statement:  "IF  A  or  B  and  C  or  D"  will  be  true  when: 

1.  A  is  true  regardless  of  B,  C,  and  D. 

2.  D  is  true  regardless  of  A,  B,  and  C. 

3.  Both  B  and  C  are  true  regardless  of  A  and!  D. 

The  statement  is  false  for  all  other  conditions. 

Relationship  is  specified  by  use  of  the  terms: 

EQ  for  equal 
NQ  for  not  equal 
LS  for  less  than 
GR  for  greater  than 

GQ  for  not  less  than  (greater  than  or  equal) 

LQ  for  not  greater  than  (less  than  or  equal) 

In  subsequent  discussions  the  field  description  preceding  the  relationship 
term  is  referred  to  as  the  "object  field."  The  field  description 
following  the  relationship  term  is  called  the  "referent  field."  Examples 
of  the  use  of  condition  statement  are  w'ven  in  section  F. 
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Spec  i  .ul  rnu; 


Che  t.» ■  :*m:;  ANY,  MONK,  KKXT,  NUMERIC,  WORD,  END,  ENDA,  ENDD,  SUFFIX,  anil 
PREFIX  ruqu ire  ape;:  1  ill  description. 

‘  UuRl.1,  SUFFIX,  and  PREFIX  are  applicable  to  the  PRINT  and  FORMAT 

•  i  vut-ori:.  inly  and  provide  user  control  of  textual  data  handling*  The 
tern  SCAN  and  its  object  describe  the  textual  data  field.  ‘Hie  user  may 
chu«.  sc  up  to  five  alphanumeric  characters  that  may  be  declared  as  word 
sepurutors.  The  beginning  and  ending  positions  occupied  by  the  textual 
field  determine  that  field  as  if  it  were  bounded  by  word  separators.  A 
word  is  a  string  of  alphanumeric  characters,  preceded  and  followed  by  at 
least  one  word  separator.  A  word  must  not  exceed  132  characters  in 
length.  Words  are  scanned  in  sequence,  commencing  with  the  left-most  or 
lowest  numbered  position  of  the  textual  field. 

The  term  WORD  refers  to  the  word  last  scanned.  The  terms  NEXT  WORD  refer 
to  the  word  about  to  be  scanned  and  cause  the  word  to  be  operated  upon. 

The  term  PREFIX  refers  to  all  preceding  characters  in  the  text  field  up  to 
but  net  including  the  current  word. 

The  term  SUFFIX  refers  to  all  following  characters  in  the  text  field 
including  the  separator  character  that  terminated  the  current  word. 

The  term  MORE  may  be  used  only  as  the  object  of  a  test.  The  condition 
tested  by  "IF  MORE"  is  true  when  there  are  words  remaining  in  the  textual 
field  that  have  not  been  scanned.  Textual  field  processing  will  be 
described  in  more  detail  in  subsequent  paragraphs. 

A.  •  *ern  END  when  used  in  PRINT  or  FORMAT  as  the  object  of  a  test  refers 
•-v.  the  condition  end-of-file  for  the  input  data.  For  example,  "IF  END 
STOP  ELSE.  DO  A"  expresses  a  test  for  end-cf- input-file  wherein  if  the 
condition  is  true,  return  is  made  to  MADAM  system  control.  If  the 
condition  is  false,  operation  is  continued  at  label  A.  Note  that  the 
term  ELSE  is  followed  by  a  period  and  is  therefore  a  MADAM  label.  It  Is 
required  to  mark  the  termination  of  the  string  of  actions  to  be  taken  if 
the  tested  condition  is  true. 

'ilu.'  terms  ENDA  and  ENDB  have  similar  meaning  for  SUBSET  and  ABSTRACT 
perutions  and  refer  respectively  to  end-of-file  for  the  input  data  Pile  A 
and  end-of-flle  for  the  index  or  selector  data  Pile  B. 

The  term  NUMERIC  is  used  as  a  condition  and  specifies  u  teat,  that  is 
uppllea  t>.  each  character  cf  the  object  field.  For  example,  "IF  IN  0, 

Eq  NUMERIC"  would  be  true  if  every  character  in  relative  positions 
i  •  !iru  A  : n  region  IN  was  u  number.  Note  that  NUMERIC  foay  only  be  used 
; tiii-  referent  field  position;  thus  the  statement  "IF  NUMERIC  KQ  IN  0, 

...  i  I  legal  . 
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The  tern  ANY  nay  precede  any  object  field  specification  thai  is  a  part 
of  a  condition  statement.  For  instance,  "IF  ANY  IN  0,9  EQ  (2)”  is  a 
legal  Torn.  "IF  (2)  EQ  Air/  IN  0,5"  while  logically  corred  is  not 
properly  translated  by  the  current  MADAM  System.  The  presence  of  the 
tern  ANY  has  two  effects  on  the  test  that  will  be  performed. 

(1)  The  object  field  will  be  considered  as  a  configuration  of 
characters  rather  than  03  a  value.  Thus,  characters  that  are 
not  correctly  differentiated  in  value  comparisons,  such  an  zero 
and  blank,  will  be  tested. 

(2)  The  referent  field  an  a  group  of  characters  of  given  size  will 
be  compared  with  successive  groups  of  equal  size  in  the  object 
field. 

In  the  example,  IF  ANY  IN  0,5  EQ  (2),  if  the  number  2  occupies  any  position 
in  the  object  field  IN  0,5  the  condition  will  be  true.  The  test  "IF  ANY 
(O2U60)  EQ  IN  0,1"  will  be  turp  only  if  IN  0,1  is  an  even  number. 

Conditional  tents  modified  by  the  term  ANY,  where  object  and  referent 
field  are  of  equal  size,  are  executed  by  the  MADAM  System  more  rapidly 
than  normal  value  comparison  tests. 

The  term  NEXT  may  be  used  in  a  data  field  description  to  replace  the 
relative  position  term.  For  example,  ’'SET  IN  0,5  at  OUT  0  SET  IN  NEXT, 

5  at  OUT  NEXT"  specifics  transfer  of  two  adjacent  fields  from  region  IN 
to  adjacent  positions  in  region  OUT-  Use  of  the  term  NEXT  in  the  above 
context  is  valid  for  input  and  output  regions  only.  Furthermore,  the 
term  NEXT  refers  to  different  data  fields  when  used  in  connection  with 
different  specific  input  and  output  regions.  The  destination  of  a  given 
NEXT  transfer  is  relative  to  the  character  position  in  the  specific 
destination  region  which  has  been  established  by  previous  transfer 
operations.  The  following  illustrates  this  complex  notion: 

GET  IN  50,5  at  OUT  25 

SET  IN  NEXT, 5  at  OUT  NEXT 

Each  NEXT  in  this  example  i3  independently  defined  and  represents  totally 
different  data  3tring3.  "SET  IN  50,5  »t  OUT  25"  defines  "IN  NEXT"  as 
the  object  field  IN  55*  It  defines  OUT  NEXT  to  be  the  destination 
location  OUT  30-  "SET  IN  NEXT, 5  at  OUT  NEXT"  actually  transfers  IN  55,5 
to  OUT  30.  Now,  3incc  NEXT  is  dynamically  redefined  with  each  operation, 

IN  NEXT  has  become  IN  60,  and  OUT  NEXT  has  become  OUT  35- 

The  use  of  NEXT  to  declare  string  processes  should  be  carefully  proofed 
to  avoid  data  region  overflow.  No  system  safeguards  against  such  overflow 
are  provided. 
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Data  Terms 

The  form  of  a  data  term  has  been  Introduced  previously  In  the  example 
"SET  IN  0,5  at  OUT  0."  A  data  field  description  is  composed  of  three 
or  fewer  terms.  The  first  of  these  is  a  region  name.  In  the  above 
example  the  terra  IN  is  a  region  name  referring' to  the  data  input  region. 
The  second  data  term  is  a  relative  position  in  the  named  region  occupied 
by  the  left-most  character  of  the  field.  The  above  described  field 
starts  at  relative  position  Q  the  first  position,  in  region  IN.  The 
third  data  term  specifies  the  numb  of  character  positions  comprising 
the  field.  In  the  example,  the  desi  ribed  field  has  five  characters  or 
numbers.  The  data  field  descriptior.  OUT  0  does  not  have  a  third  term  as 
it.  conveys  location  information  only-  Destination  descriptions  do  not 
require  a  third  (size)  term. 

Often  a  user  wishes  to  refer  to  a  constant  value  in  place  of  a  data  field. 
An  alternative  form  is  provided  for  such  litoral  data  entities.  Any 
string  of  alphanumeric  characters  enclosed  in  parentheses  is  interpreted 
as  a  literal  value.  An  example  above,  "IF  ANY  (02468)  EQ  IN  0,1" 
illustrates  the  use  of  literal  (02468). 


Some  examples  of  data  field  specification  are  .given  below. 


INA  10,5 


INB  500,100 


OUT  NEXT  5 


The  string  cf  sequential  characters  in  the 
region  labelled  INA,  the  input  data  region 
for  ABSTRACT  and  SUBSET,  beginning  at  relative 
position  10  in  that  region  and  consisting  of 

The  string  of  sequential  characters  in  the 
region  labelled  INB,  the  index  or  selector 
data  region  for  ABSTRACT  and  SUBSET,  beginning 
at  relative  position  500  Ir.  ’hat  region  and 
consisting  of  100  characters. 

The  string  of  five  sequentia 1  characters 
immediately  following  the  field  previously 
specified  m  region  OUT. 


The  first  relative  position  in  any  region  i:>  o.  Fields  may  not  exceed 
132  characters  in  length. 


Dynamic  and  Indirect  Addressing 

In  more  complex  data  manipulation  cJterc  men,  n  great  saving  ir  volume  of 
specification  can  be  effected  by  the  generation  of  object  data 
addresses  dynamically  and  by  iterative  looping.  In  the  MADAM  System 
these  functions  are  accomodated  via  the  prime  operation  in  conjunction 
with  the  operator  DO. 
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You  will  recall  that  data  fields  are  specified  by  two  or  three  data 
terms.  The  first  term  is  a  region  name.  The  second  and  third  terms 
are  numbers  specifying  the  relative  start  location  and  size,  respectively, 
of  a  data  field.  If  either  or  both  of  the  number  terms  of  a  data  field 
description  are  followed  immediately  (with  no  intervening  blank  or  comma) 
by  a  "prime"  character  (U-8  punch),  the  numbers  are  interpreted  as  relative 
addresses  referring  to  3  digit  fields  in  region  TEMP.  The  numeric  data 
in  region  UMP  at  the  relative  address  specified  is  used  as  a  relative 
start  or  size  parameter.  For  example,  if  region  TEMP  contains  the  value 
"OUOO6"  in  relative  positions  TEMP  0,6  the  action  "SET  IN  O',  3'  AT 
OUT  O'"  would  in  effect  "SET  IN  11,6  AT  OUT  11."*  The  values  in  region 
TEMP  are  numeric  and  fully  manipulatable  through  the  arithmetic  operators 
of  MADAM. 

The  prime  operator  is  invalid  for  use  with  data  regions  other  than  IN, 

INA,  INB,  OUT,  and  TEMP.  Any  other  usage  will  result  in  an  error  message 
and  abort  of  translation. 

Implicit  Terms 

For  data  field  descriptions,  when  the  region  name  is  omitted,  region 
IN  for  PRINT  or  FORMAT  or  region  INA  for  aBSTHACT  or  SUBSET  is  assumed 
with  the  following  exceptions . 

(1)  For  a  destination  description  like  OUT  0,  region  OUT  is 
assumed. 

(2)  For  the  action  »,  region  OUT  is  assumed. 

The  PRINT  operation  assumes  60  lines  per  page  if  no  REPORT  action  takes 
place . 

If  no  test  for  input  end-of-file  is  made  in  a  specification,  automatic 
termination  will  occur  on  the  first  input  end-of-file.  If,  in  an 
ABSTRACT  specification,  test  is  made  for  end-of-file  input  A  and  no 
corresponding  test  made  for  input  B,  automatic  termination  will  occur 
on  end-of-file  input  B.  If  the  user  provides  for  both  end-of-file  tests, 
he  must  then  terminate  his  operation  via  a  STOP  action. 


Anyone  familiar  with  index  register  usage  in  a  general  purpose  computer 
will  note  that  the  effect  of  the  PRIME  operation  is  to  provide  up  to  33 
independent  index  registers  for  SUBSET  and  ABSTRACT  and  up  to  66  such 
registers  for  PRINT  and  FORMAT. 
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Daring  the  FORMAT  operation  no  carriage  control  actions  will  be  taken 
unless  a  PRINT  action  has  been  used  in  the  specification. 

Special  MADAM  Terms 

At  the  end  of  any  set  of  operation  specifications--after  the  END  statement, 
for  all  but  COPY  and  COMBINE--and  before  the  operation  declaration 
initialing  the  next  set  of  specifications,  the  system  will  accept  a  control 
card  with  ****  followed  by  a  message  to  be  logged  on  the  printer.  Since 
the  usual  purpose  of  such  a  message  is  to  direct  the  computer  operator  to 
perform  some  support  task,  the  system  will  halt.  Operation  will  resume 
when  the  operator  presses  START.  Between  specifications  as  defined  above, 
any  text  string  on  any  number  of  cards  may  be  excluded  from  consideration 
by  the  translation  process  by  preceding  and  following  the  text  string  with 
a  pair  of  sequential  asterisks  **  preceded  and  followed  by  at  least  one 
blank. 
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IV.  USING'  THE  MADAM  SYSTEM 


A.  File  Building 

There  are  several  MADAM  operations  applicable  to  file  building. 

The  LOAD  operation  is  provided  to  optimize  certain  standard  file 
building  processes  while  minimizing  user  communication.  Where  the 
nature  of  the  data  or  file  structure  is  such  that  LOAD  cannot  be 
effectively  employed,  the  operations  FORMAT  and/or  SUBSET  may  be 
used.  In  FORMAT  and  SUBSET  operations,  the  user  must  describe  the 
file  building  process  in  detailed  procedural  form,  expressing  each 
conditional  test  and  related  transfer  action  necessary.  He  would 
choose  between  FORMAT  and  SUBSET  on  a  basis  of  file  structural 
complexity  versus  record  size.  The  FORMAT  operation,  due  to  its 
greater  number  of  possible  conditional  operations,  can  handle 
complex  structures.  The  SUBSET  operation  makes  available  greater 
internal  data  storage  3pace  at  the  expense  of  some  limitation  in 
flexibility. 

B-  File  Update 

The  process  of  file  updating  involves  merging  data  from  an  update 
source  into  file  records  already  in  existence.  Records  in  the 
existent  file  may  be  created,  changed,  or  deleted.  The  ABSTRACT 
operation  is  provided  for  this  purpose.  Data  from  two  input  files 
can  be  combined  in  any  logical  or  arithmetic  way  fo,r  inclusion  in 
one  or  two  output  files. 

C.  File  Organization  . 

The  SORT  operation  i6  provided  to  permit  the  records  of  a  file  to 
be  placed  in  ascending  collating  sequence  on  selected  character 
sets.  Standard  1^01  collating  sequence  is  used.  This  sequence  Is 
illustrated  in  Appendix  A  of  this  volume. 

A  descending  collating  sequence  can  be  generated  by  first  sorting 
into  ascending  sequence,  then  generating  sort  keys  in  inverted 
order  of  numeric  value,  appending  these  generated  keys  to  each 
record,  and  finally  sorting  once  again  by  the  generated  key.  The 
SUBSET  operation  can  be  used  for  sort  key  generation.  Other 
sequences  can  be  produced  in  like  fashion. 
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D.  Selecting  a  Subset  from  a  File 

The  SUBSET  operation  provides  for  the  selection  of  a  subset  file 
on  a  basis  of  logical  or  arithmetic  criteria.  Where  the  criteria 
for  selection  are  related  to  properties  represented  in  an  input 
file  different  from  the  one  being  subset,  the  ABSTRACT  operation 
can  be  employed.  The  second  input  file  would  contain  a  list  of 
identities  to  be  selected  from  the  object  file.  In  the  latter 
case,  both  input  files  to  the  ABSTRACT  operation  should  be  ordered 
similarly. 

E.  Aggregation  of  Records  Within  a  File 

Records  within  a  file  may  be  grouped  together  into  a  single  record 
or  into  sequential  records  of  manageable  size,  either  arbitrarily 
or  on  a  logical  basis  by  the  BLOCK  operation. _  Aggregation  may  be 
desirable  in  order  to  conserve  magnetic  tape  storage.  Each  physical 
record  on  magnetic  tape  is  followed  by  three-fourth  inch  of  unused 
tape.  Larger  records  minimize  unused  tape.  Aggregation  on  a 
logical  basis  may  be  used  as  part  of  the  process  of  file  building. 
Records  having  the  same  identity  are  grouped  together  in  a  single 
block,  thus  larger  and  fewer  records  need  be  sorted  in  the  organi¬ 
zation  process. 

Aggregation  of  Files  into  a  Single  File 

Related  data  from  several  different  files  may  be  needed  to  produce 
a  report.  The  required  data  would  be  selected  from -the  originating 
files  by  SUBSET.  Each  selected  record  would  be  given  an  identity 
key  as  a  logical  basis  for  association  with  appropriate  records 
from  other  files.  The  resulting  subset  files  would  be  combined 
into  a  single  file  through  use  of  the  COMBINE  operation.  The  final 
file  would  be  ordered  on  the  identity  key,  thu6  grouping  associated 
records  together.  Finally,  the  PRINT  operation  would  prepare  the 
printed  report. 

G.  Report  Generation 

The  PRirrr  operation  is  provided  foo  the  preparation  and  printing  of 
reports  or.  the  direct  printer.  Where  other  peripheral  devices  are 
employed  for  report  generation,  the  FORMAT  operation  can  prepare 
formatted  records  for  input  to  these  devices  via  magnetic  tape. 

Table  1  below  contrasts  the  relative  capabilities  of  the  procedural 

opera- ions  in  the  MADAM  System. 


t  ZTOY1 
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Examples 

A  set  of  MADAM  specif ication3  used  to  prepare  a  key-word-in-context  listing 
of  personal  document  files  is  presented  below.  Each  MADAM  statement  is 
explained  in  detail. 


'.lie  input  data  for  the  first  operation  were  in  IBM  punched  card  form.  Card 
columns  1  thru  25  contain  topic  tags,  in  this  case  parts  of  the  document 
titles.  Card  columns  6l  and  62  contained  alphabetic  codes  representing 
document  classification  groups.  The  first  MADAM  operation,  a  FORMAT, 
selected  the  data  fields  from  card3  that  were  to  receive  further  processing, 
eliminated  extra  blank  characters  that  may  occur  between  topic  tags,  and 
inserted  a  special  non-blank  character  that  printed  as  a  blank  between 
each  tag. 


FORMAT  1,2  FROM  CARDS 


GET  (5  blanks)  AT  TERM  0 


1.  read  sca:j  0,25 

SET  60,2  AT  OUT  5 
SET  (  )  AT  OUT  9 


The  FORMAT  operation  vus  chosen 
so  textual  sorm.i n  :  con’d  be  •!<•>.«  . 
The  output  file  was  file  1  on 
unit  2.  The  input  data  were  on 
cards . 


All  five  of  the  alternate  word 
separator  characters  were  specified 
to  contain  blanks.  That  is,  all 
alphanumeric  characters  except in  : 
blanks  may  constitute  a  word. 


This 

if tt 

*  ♦. 

-  i.  • 


string  of  actions  is  labelled 
so  that  return  can  be  made  to 
The  WAD  action  acquirer.  *he 
t  innu;:  card.  ir.c  action  DDA'i 


specified  region  IF  C  through 
'if  r-  rr.  n  lc>".  uul  !Vei:.  fur 
re  :'<r.  in.: el  ’r  implicit.  'Me 
n-u ion  CL\  .2,2  at  OUT'  5,  again 
with  the  implicit  region  label  IF, 
transfers  the  two  character 
classification  code  from  relative 
position  XII  60  (column  1  of  ;hc 
data  card  becomes  relative  position 
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0  in  region  IN)  to  OUT  5  and  OUT 
0.  The  action  SET  (  )  at  OUT  9 
transfers  a  blank  to  pocition  OUT 
9.  This  action  is  used  solely  to 
Initialize  the  OUT  NEXT  location 
at  OUT  10, 

SET  NEXT  WORD  AT  OUT  NEXT  This  action  has  u  dual  purpose. 

SET  (  )  NEXT  First  the  MADAM  terms  IhSW  WOKD 

cause  the  next  word  in  the  textual 
field  to  be  located.  Second,  the 
SET  action  transfers  the  word  to 
the  next  position  in  region  OUT. 
The  action  SET  (  )  NEXT  places  the 
blank  printing  special  non-blank 
character  following  the  word.  The 
character  used  was  a  12/5/8  punch. 

IF  MORE  DO  2  This  test  and  DO  action  causes  the 

complete  string  of  topic  tags  to 
be  found  and  transferred  as  above. 
When  there  are  no  more  words  (the 
tested  condition  is  false)  the 
1  next  test  or  label  is  taken,  in 
this  case  label  3. 

Eighty  characters  beginning  with 
the  character  at  position  OUT  0 
urc  written  onto  file  1  on  unit  2. 
The  SET  IN  100,  80  AT  OUT  0  takes 
udvantage  of  the  fact  that  region 
IN  100  and' up  is  not  used  in  this 
operation  and  therefore  contains 
blank  characters.  This  clears  the 
OUT  region  to  blanks .  The  DO  1 
action  causes  return  for  a  subse¬ 
quent  input  card. 

END  The  END  terra  signals  to  the  MADAM 

translator  that  a  complete  set  of 
operation  parameters  have  been 
prepurod.  The  translator  passes 
control  to  the  operating  program. 


3.  WRITE  OUT  0,80 

NET  IN  100,80  at  OUT  0 
;c  i 


The  above  specification,  upon  completion  of  operation  logged  "END  OF 
FUJI  TAPE  0"  on  the  line  printer  signifying  that  an  end  of  file  card 

(12/7/8  punch  in  'cVnn  >)  it  *. i  been  rend. 


oifwi/f  uata  nm  thk  n  wwa'cion 
imfT  TO  THK  9HJ0NP  OPWATION 


1*0 
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The  following  specified  MADAM  operation,  again  a  FORMAT  so  that 
textual  data  fields  could  be  handled,  followed  immediately  after  the 
previous  operation  with  no  operator  intervention  required.  This 
second  operation  performed  the  actual  key-word-in-context  permuting 
of  topic  tags.  Ftor  each  topic  tag,  a  record  was  written,  formatted 
such  that  topic  tags  occupied  the  same  relative  position  in  each 
output  record,  and  preceding  and/or  following  words  retained  their 
proper  position.  To  guarantee  a  proper  sort  order  of  topic  tags 
(without  following  words  effecting  the  order)  each  topic  tag  was 
duplicated  as  the  trailing  data  field  in  the  record. 

FORMAT  1,3  FROM  1,2  File  1  unit  2,  the  output  file 

from  the  previous  process,  became 
the  input  file  to  this.  Output 
was  written  onto  file  1  unit  3. 

SETT  (4  blanks  and  a  special  Four  of  the  alternate  word, 
character)  AT  TERM  0.  separators  were  Bet  to  blank  and 

The  character  used  was  a  one  was  set  to  the  special  character 

12/ 5/0  punch.  placed  by  the  previous  process. 

1.  READ  SCAN  10,36  The  prior' process  placed  the  textual 

data  at  OUT  10.  That  location 
became  IN  10  in  this  operation. 
Thirty- six  characters  were  included 
in  the  textual  field  to  permit  this 
specification  to  be  used  as  an 
initial  process  for  specially 
formatted  input  cards  having  36 
character  textual  fields. 

The  action  SET  NEXT  WORD  AT  OUT  25 
acquired  a  word  from  IN  10  thru  IN 
1*5  and  positioned  it  so  that  its 
leading  character  occupied  OUT  25 
and  following.  The  action  SET 
SUFFIX  NEXT  transferred  all 
characters  of  the  textual  field 
that  followed  the  particular  word 
to  adjacent  positions  so  as  to 
maintain  trailing  context.  The 
action  ADJUST  PREFIX  AT  OUT  2U, 
because  of  the  non-blank  special 
characters  between  words,  trans¬ 
ferred  all  of  the  textual  field 
that  preceded  the  particular  word, 
positioning  it  so  its  last  character, 


2.  SET  NEXT  WORD  AT  OUT  25 
SET  SUFFIX  NEXT 
ADJUST  PREFIX  AT  OUT  2k 
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SET  5,2  AT  OUT  G? 
SET  WORD  AT  OUT  Gh 


WRITE  OUT  0,80 

SET  IN  100,80  AT  OUT  0 


IF  MORE  DO  2 


3.  DO  1 


END 


in  this  case  u  blank-print  inti 
special  character,  adjoined  the 
particular  word  on  the  left, 
maintaining  preceding  context. 

The  action  SET  5><-  AT  OUT  02  trans¬ 
ferred  the  classification  code  to 
position  OUT  6.'  and  OUT  63.  The 
next  action  set  the  topic  tag  at 
OUT  64  and  following  as  a  sort  key. 

The  resulting  record  as  it  was 
configured  in  region  OUT  was 
written  onto  file  1  unit  3  and  the 
OUT  region  cleared  to  blanks  as 
before. 

An  output  record  for  each  topic 
tag  was  assured.  After  the  last 
topic  tag  in  a  textual  field, 
label  3  vac  taken. 

The  string  of  actions  from  label 
1  thru  label  3  war.  performed  for 
each  record  from  file  1  unit  2 
until  end  of  file  on  unit  2. 

END  signaled  end  of  translation 
and  start  of  operation  as  above. 


No  specified  end  of  file  test  was  required  in  cither  of  the  above 
operations.  In  both  cases,  the  operation  was  terminated  automatically 
by  the  system  when  end  of  file  occurred  on  the  input  data  file.  In 
the  last  operation,  "END  OF  FILE  TAPE  2"  was  logged  on  the  line 
printer. 


File  1  on  unit  3  now  contained  key-word-in-context  data  records  but 
they  were  arranged  in  order  of  occurrence  on  topic  tags.  The  next 
specification,  again  executed  without  intervention,  caused  rearrange¬ 
ment  into  alphabetic  sequence  of  topic  tags. 

SORT  1,3  BY  64,10,80  PAUSE  END  The  sort  key  placed  at  OUT  by  the 

previous  .specification  was  used 
for  ordering.  Ten  characters 
were  considered  sufficient  for 
proper  order. 
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At  the  completion  of  the  first,  or  distribution  pass  of  the  SORT 
operation  the  message,  "PASS  1  COMPLETE.  REPLACE  INPUT  REEL  IF 
DESIRED,  CONTINUE"  vus  logged  on  the  direct  printer'and  the  system 
come  to  a  programmed  halt.  The  operator  pressed  the  sturt  button 
without  saving  the  input  data  reel.  File  unit(3  was  written  over  by 
the  subsequent  passes  of  SORT  and  ultimately  became  the  alphabeti¬ 
cally  ordered  data  file. 

At  the  completion  of  the  SORT  operation,  "SORT  COMPLETE,  009  PASSES" 
was  logged  and  the  following  specifications  were  accepted  without 
further  intervention.  This  operation  generated  reordering  keys  to 
provide  half-page  formatting  for  the  printed  output  of  5 6  lines  per 
page.  It  assigned  odd  sequence  numbers  starting  with  "1"  to  subse¬ 
quent  records  until  the  number  "111"  had  been  assigned  at  which 
time  it  commenced  assigning  even  sequence  numbers  starting  with  "2." 
When  the  even  number  "112"  had  been  assigned,  a  page  number  was 
incremented  and  the  process  repeated  for  all  records  in  the  file. 

FORMAT  1,2  FROM  1,3  The  previously  ordered  data  file 

became  input  to  this  process. 

File  1  unit  2  was  written  over 
for  output. 

1.  COMPUTE  TEMP  0, 3  +  (1)  =  A  page  sequence  number  was  estab- 

TEMP  0,3  lished  in  TEMP  0.  It  was 

initialized  at  the  value  "1." 

2.  COMPUTE  TEMP  3*3  +  (l)  “  A  record  or  half-line  sequence 

TEMP  3,3  number  was  established  at  TEMP  3 

and  initialized  at  "1." 

READ  An  input  record  was  acquired  in 

region  IN  commencing  at  IN  0.  , 

SET  TEMP  0,6  AT  IN  64  The  current  value  of  page  and 

half-line  number  was  set  into  the 
input  record  at  tne  position 
previously  occupied  by  the  topic 
tag  sort  key. 

WRITE  IN  0,70  Seventy  characters  were  written 

onto  file  1  unit  2  from  region  IN 
0  thru  IN  69. 

COMPUTE  TEMP  3,3  >  (1)  -  The  half-line  sequence  number  was 

TEMP  3,3  incremented  by  one.  At  this  point, 

the  number  was  even  during  the  odd 
number  assignment  sequence  and  Ovid 
during  the  even  sequence. 
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IF  TEMP  3,3  EQ  (112) 

SET  (OOl)  AT  TEMP  3  DO  2 

3.  I?  TEMP  3,3  EQ  (113)  Advantage  vas  taken  of  this  to 

establish  tests  for  end  of  odd  and 
SET  (000)  AT  TEMP  3  DO  1  even  cycles.  At  the  end  of  the 

odd  cycle  TEMP  3, 3  contained  "112" 
and  reinitializing  at  "l”  caused 
the  sequence  number  ”2”  to  be 
assigned  first  at  label  2.  At 
the  end  of  the  even  cycle  TEMP 
3,3  contained  "113''  and  reinitial¬ 
izing  at  "0" re-established  odd 
number  generation  at  step  1.  Note 
that  label  3  Is  required  to  mark 
the  end  of  actions  to  be  taken 
when  the  preceding  te6t  is  true. 

h.  DO  2  label  4  marks  the  end  of  actions 

to  be  taken  vhen  the  test  labelled 
3  is  true,  label  h  constitutes, 
in  effect,  a  statement  "otherwise. " 

END  END  marks  the  end  of  this  specifi¬ 

cation. 

"END  OF  7UX  TAPE  3"  vas  logged  on  the  printer  at  the  end  of  this 
operation.  The  resulting  sequence-numbered  file  on  unit  2  was  now 
sorted  into  sequence  number  order. 

SORT  1,2  BY  6*4,6  END  specified  thin. 


"SORT  COMPIETE.  002  PASSES"  was  logged  at  the  end  of  this  sort. 
Only  two  passes  were  taken  as  the  data  file  required  only  simple 
merging  of  odd  and  even  records. 

The  next  and  last  specification  formatted  the  final  printed  output. 

1 

PRIM?  1,2  The  PRINT  operation  was  chosen. 

The  ordered  file  1  on  unit  2 
contained  the  input  data. 


IX* eei-ibr  v  LOG lj  'j G 


SETT  (02U60)  AT  TEMP  10 
HEAD 


1.  GET  25,3  AT  TEMP  0 


2.  SET  0,6U  AT  0 


READ  IF  END  PRINT  DO  5 


DA.  GET  25,3  AT  TEMP  3 


IK  ANY  TEMP  .10,5  EQ  IN  6$>,1 


TM-.I^G/OO.  •/<>'. 


A  character  string  representing 
all  possible  even  digits  was  .  » 

stored  at  TEMP  10  in  preparation 
Tor  odd-even  teGting.  An  initial 
record  was  read  Troin  file  1,  unit 
2  into  region  IN  at  IN  0  and 
following. 

The  first  three  characters  of  the 
first  topic  tag  on  each  page  were 
3aved  at  TEMP  0  thru  TEMP  2. 

These  were  used  later  at  step  5 
to  provide  alphabetic  page  content 
reference. 

Both  region  IN  and  region  OUT  were 
implied.  The  action  statement  SET 
IN  0,6t  AT  OUT  0  would  be  equally 
appropriate.  This  action  set  the 
first  half-line  at  position  0  in 
the  priqt  image. 

The  record  containing  the  next 
half- line  was  read  into  region  IN 
at  IN  0.  A  test  was  made  to  see 
if  end-of-file  had  been  reached. 

If  so,  the  print  image  containing 
the  first  half- line  only  was 
printed  and  operation  taken  up  at 
step  5  vhere  the  page  reference 
data  line  was  prepared. 

The  first  three  characters  of  each 
successive  topic  tag  after  the 
first  of  any  page  were  saved  at 
TEMP  3  thru  TEMP  5.  These  provided 
u  terminal  alphabetic  content 
reference  for  the  page. 

No  label  was  required  to  terminate 
the  previous  action  string  since 
it  wao  followed  by  a  test.  This 
test  will  be  true  if  the  single 
character  at  IN  69,  the  last  digit 
of  the  half- line  sequence  number, 
is  even.  You  will  recall  that  a 
literal  value  (02U68)  was  placed 
at  TEMP  10  earlier. 
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SET  0,6k  AT  67  READ 


IF  END  PRINT  DO  5 


3.  PRINT 


IF  LINE  0,3  EQ  (57)  DO  5 


4.  DO  2 


5-  SKIP  2 


SET  (-)  AT  6h 
SET  PAGE  0,3  AT  65 
SET  (-)  AT  68 


SET  TEMP  0,3  AT  125 
SET  (-)  AT  128 
SET  TEMP  3>3  AT  129 


If  this  half- line  had  an  even 
sequence  number  it  was  u  second 
half-line  and  was  placed  in  the 
print  image  at  print  position  67. 
Another  record  was  read  into 
region  IN  at  IN  0. 

Again  a  check  was  made  for  end-of- 
file.  As  before,  if  there  were 
no  more  lines  to  be  printed, 
operation  was  taken  up  at  step  5* 
Observe  that  this  test  will  be 
made  whether  or  not  the  half-line 
was  even  numbered. 

The  data  in  the  print  image  was 
printed  here  when  there  hod,  as 
yet,  been  no  end-of-file.  The 
print  image  could  have  only  a 
first  half -line  or  it  could  have 
both  half-lines. 

After  the  56th  line  hud  been 
printed,  the  line  counter,  LINE 
0,3  contained  a  value  "57* M  If 
this  page  was  complete,  step  5, 
where  a  page  reference  line  was 
prepared,  was  taken. 

If  56  lines  had  not  yet  been 
printed,  return  was  made  to  step 
2  where  the  current  record  in 
region  IN  was  processed  as  a 
first  half-line. 

Two  lines  were  left  blank  ,0 
permit  the  page  reference  to  stand 
out  from  the  data  lines. 

The  page  number  in  the  internal 
counter  PAGE  0,3  was  placed  in 
the  reference  .line  image  preceded 
and  followed  by  a  dash. 

The  previously  stored  page  starting 
and  ending  alphabetic  reference 
characters  were  placed  in  the 
reference  line  image  separated  by 
a  dash, 


TM-2.19C/002/00 


i  *  .  *  V. 


print  restore 


IF  END  STOP 


6.  10  1 


end 


The  net  of  I'/kHAH  epee 
the  textual  field  pro; 
i  arithmet  ic  aetionSj 
uctior.3,  transfer  nctl 


i-n 

JK> 


i»:e  last  or  reference  line  for 
the  pa^c  was  printed  and  the 
printer  carriage  restored  to 
print  at  the  top  of  the  next  pane. 

# 

If  step  5  Had  been  tahen  by  reason 
of  end-erf -file,  this  -test  caused 
term! rat  ion  of  printing  and  return 
■to  MA&AM  System  control  . 

If  there  were  records  remaining- 
to  be  printed,  return  v.-as  made  to 
step  1  where  page  fonnattinc  be^an. 

END  terminated  the  translation  of 
the  PRINT  specifications  and 
Initiated  operation. 

If j cations  outlined  above  Illustrate  a  use  of 
'easing  operation  ao  well  as  simple  applications 
,  the  proper  use  of  labels,  elementary  print 
Ions,  and  DO  actions. 
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V.  MADAM  SYSTEM  COMPUTER  OPERATIONS 

The  MADAM  System  Version  IV  is  maintained  in  the  form  of  a  master  magnetic 
tape.  This  MADAM  MASTER  tape  contains  a  system  generator  program,  as  the 
first  record,  followed  by  the  programs  of  the  MADAM  System  as  AUTOCODER  out¬ 
put  symbolic  card  records  terminated  by  a  tape  mark  (end-of-file) .  The  MADAM 
MASTER  tape  is  stored  in  a  file-protected  condition  (the  write  ring  is 
removed  from  the  tape.  reel). 

The  MADAM  Operating  System  tape  is  generated  from  the  MADAM  MASTER  tape  by 
the  following  actions : 

0)  Place  the  MADAM  MASTER  on  unit  1  rewound  to  load -point. 

(2)  Place  a  suitable  blank  or  pool  tape  on  unit  2  rewound  to  load -point. 

(j)  Reset  at  the  console,  press  LOAD  FROM  TAPE. 

The  MADAM  Operating  System  will  be  generated  on  unit  2.  Doth  reels 
will  rewind  at  the  end  of  the  operation. 

The  MADAM  Operating  System  tape  operates  from  tape  unit  1. 

(R)  Dial  unit  2  to  unit  1. 

(5)  Remove  the  MADAM  MASTER  and  re-assign  its  tape  unit. 

From  this  point,  MADAM  Version  IV  System  operations  are  similar  to  previous 
versions. 

♦ 

The  MADAM  MASTER  tape  described  above  may  be  copied  onto  another  reel  via 
the  standard  MADAM  function  COPY. 

The  system  i3  called  into  operation  initially  by  a  LOAD  FROM  TAPE  action  at 
the  computer  console.  Specification  cards,  and  data  cards  if  used,  are 
faded  in  the  card  reader.  Appropriate  data  files  on  magnetic  tape  are 
loaded  on  the  specific  tape  units  corresponding  to  specification  card 
instructions,  ihc  system’s  first  action  is  to  read  a  specification  card. 

All  subsequent  system  operations  are  directed  by  cards. 

Operation  specifications  that  are  stacked  in  the  card  reader  vill  be  run 
continuously  without  interruption.  When  the  card  reader  becomes  empty,  the 
system  logs  "CARD  READER  EMPTY"  and  pauses  ready  to  read  the  next  card-  (Due 
to  the  nature  of  the  EJM  1^01,  it  le  convenient  to  include  two  blank  carda 
following  the  last  specification  card.  These  cards  pormit  all  control  carda 
to  be  read  before  the  card  reader  becomes  inoperative  due  to  an  empty  read 
hopper.) 
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To  pernlt  scae  operator  control  cf  diagnostic  process  and  functional 
Messages,  sense  switch  options  are  provided  as  follr-r : 


SEBSK  SWITCH 
A 

B 


C  &  3 
E 


MEANING 

Always  or.  tc-  permit,  cord  reader  enpty 
tc  tc  sensed  by  the  system. 

On  -  Returns  to  try  1C  aore  tiaes  to 
read  a  tad  tape  record  after 
error  halt. 


Cff-  Bypasses  bad  tape  record  after 
error  halt. 

Sot  assigned. 


On  -  Printing  of  the  first  card  of  a 
specification  is  suppressed. 


On  -  Printing  of  all  but  the  first  card 
of  a  specification  is  suppressed. 


Ch  -  Core  aenory  is  dussped  via  the 
direct  printer  following  the 
execution  cf  each  specification. 
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PRINTS 

AS 

(blank) 

• 

*  )  or 

(blank) 
(blank) 

**  (blank) 

*  +  or 

$ 

« 

(blank) 

(blank) 

(blank) 

/ 

V 

*  (  or 

(blank) 
(blank) 
(blank) 
(blank) 

*  ««  or 

*  ' 

(blank) 

(blank) 

**  (i  i  .iik) 

h  or  ¥ 
A 


03 

APPENDIX  A 

DEFINED  CHARACTER 
(blank) 

□ 

(blank)  or  ( 

(blank)  or  < 

^  Group  Mark 

& 

% 

■* 

(blank)  or  ) 
(blank)  or  ; 
(blank)  or 

/ 

I 

% 

(blank)  or  =• 
(blank)  or  1 
(blank)  or  " 

# 

<3 

(blank)  or  :  • 
(blunk)  or  >  , 
f  Tape  Mirk 
?  (Pluo  Zero) 

A 

(Continued) 
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CARD 

CODE 

12-3-8 

12-4-8 

12-5-8 

12-6-8 

12-7-8 

12 

11-3-0 

11-4-0 

11-5-8 

11-6-8 

11-7-8 

11 

0-1 

0-3-8 

0-4-8 

O-5-8 

0-6-3 

0-7-8 

3- 0 

4- 8 

5- 8 

6- 8 
7-0 
1C-0 
X8-1 
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PRIM'S 

AS 


B 

C 

D 

S 

F 

G 

H 

I 

J 

K 

T 

M 

N 

0 

P 

Q 

R 

** 

S 

T 

U 

V 
W 

X  - 

Y 
Z 
0 
1 


DEFIKKD  CHARACTER 

B 

C 

D 

£ 

F 

G 

H 

I 

!  (Minus  Zero) 

J 

K 

r 

M 

N 

0 

P 

Q 

R 

Record  Mark 
S 
T 
U 

V 
W 
X 

Y 
Z 

0 

1 


CARD 

COSE 

12-2 

12-3 

12-1* 

12-5 

12-6 

I2-? 

12-3 

12-9 

11-0 

11-1 

11-2 

11-3 

11-fc 

11-5 

11-6 

H-7 

11-8 

11-9 

0-2-8 

0-2 

0-3 

0-1* 

0-5 

0-6 

0-7 

0-8 

0-9 

0 

1 


(Continued) 


>  1  . 


*  % 
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2 

3 

4 

5 

6 

7 

8 

9 
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2 

3 

4 

5 

6 
7 
6 

9 


♦Alternate  character  on  some  print  chains. 

♦♦Characters  have  special  significance  for  MADAM  operation. 


/ 


